ai-tools-maintenance

AI Tools Maintenance Rule

AI Assistant Authority

As the AI assistant, I have the authority and responsibility to automatically maintain AI tools in sync with the BlogPostService when I detect changes that would make the tools outdated or incomplete.

When to Update AI Tools

Automatic Updates Should Occur When:

1. New BlogPostService Methods Added

   • New public methods in blog.api-client.ts
   • New API endpoints that should be exposed as tools
   • New functionality that would benefit AI agents

2. Method Signatures Changed

   • Parameter types modified
   • Return types updated
   • Input/output schemas changed

3. Method Removed or Deprecated

   • Methods no longer available in BlogPostService
   • Deprecated endpoints that should be removed

4. Schema Updates

   • New input/output types in blog-domain
   • Updated validation requirements
   • New branded types or constraints

AI Tool Structure Pattern

Standard Tool Template

Every AI tool MUST follow this exact pattern:

import { /* Required types */ } from '@t6c/blog-domain' // or '@t6c/domain-common'
import { AiTool, ToolError } from '@t6c/lib-ai'
import { Effect, String as S, Schema } from 'effect'
import { BlogPostService } from '../blog/index.js'

const tool = AiTool.make('ToolNameTool', {
  success: Schema.String,
  failure: ToolError,
  parameters: Schema.Struct({
    // Define parameters based on method signature
  }).fields,
  description: S.stripMargin(`
    | Clear description of what the tool does.
    | Include parameter explanations if complex.
    | Mention return value format.
  `),
})

const handler = ({
  // Parameters matching the schema
}: {
  // TypeScript types for parameters
}): Effect.Effect<string> =>
  Effect.gen(function* () {
    const blogPostService = yield* BlogPostService
    const result = yield* blogPostService.methodName(/* parameters */)
    return `Success message: ${JSON.stringify(result)}`
  }).pipe(
    Effect.catchAll((e) =>
      Effect.succeed(`Error message with context: ${e}`),
    ),
    Effect.provide(BlogPostService.Default),
  )

export const ToolName = {
  tool,
  handler,
}