generate-code

Generate Code Skill

Generate production-ready code based on a feature description, issue context, or note content. Writes code blocks to the current note for review and integration.

Quick Start

Use this skill when:

• User requests code generation for a feature (/generate-code)
• Agent detects an issue needs a code scaffold
• User provides a description of what code they need

Example:

User: "Generate a FastAPI endpoint for creating workspace invitations"

AI generates:
- Pydantic schema (InvitationCreateRequest, InvitationResponse)
- Service class (InvitationService.execute)
- Repository method stub (InvitationRepository.create)
- Router endpoint (POST /workspaces/{workspace_id}/invitations)

Workflow

1. Gather Context

   • Read current note content for requirements and constraints
   • Fetch related issue details if issue_id is present in context
   • Identify target language/framework from workspace or note context
   • Check existing code patterns via search_note_content for consistency

2. Plan Code Structure

   • Identify components: schema, service, repository, router (backend) or component, hook, store (frontend)
   • Determine file placement following project conventions
   • Identify dependencies and imports needed

3. Generate Code

   • Write idiomatic, production-ready code with type hints
   • Follow project conventions: CQRS-lite (backend), MobX + TanStack Query (frontend)
   • Include docstrings for public APIs
   • No placeholders, no TODOs — complete implementations only

4. Insert to Note

   • Use insert_block to write each code block as a separate code fence
   • Prepend with a brief explanation heading
   • Include file path comment at top of each block

5. Request Suggestion Approval

   • Return status: pending_suggestion for user review before integration
   • User can edit blocks directly in the note before accepting

Output Format

{
  "status": "pending_suggestion",
  "skill": "generate-code",
  "blocks_inserted": 4,
  "note_id": "note-uuid",
  "summary": "Generated FastAPI endpoint with schema, service, repository stub, and router",
  "files_referenced": [
    "backend/src/pilot_space/api/v1/schemas/invitation.py",
    "backend/src/pilot_space/application/services/invitation_service.py",
    "backend/src/pilot_space/infrastructure/database/repositories/invitation_repository.py",
    "backend/src/pilot_space/api/v1/routers/invitations.py"
  ]
}