Backend Init

Initialize backend development environment by creating the constraints file.

Language Configuration

Before generating any content, check

aico.json

in project root for

language

field to determine the output language. If not set, default to English.

Process

1. Check existing: Look for

   docs/reference/backend/constraints.md

2. If exists: Ask user if they want to overwrite or skip
3. Create directory structure:

   docs/reference/backend/
   ├── constraints.md
   └── tasks/
   

4. Generate constraints file:
   • Read template from

     references/constraints.template.md

   • Guide user through key decisions
5. Save output: Write to

   docs/reference/backend/constraints.md

Document Header Format

All generated documents MUST use this unified header format:

# [Document Title]

> Project: [project-name]
> Created: YYYY-MM-DD
> Last Updated: YYYY-MM-DD

Guided Questions

Category	Questions
Language/Runtime	Node.js, Python, Go, Rust?
Framework	Express, Fastify, FastAPI, Gin?
Database	PostgreSQL, MySQL, MongoDB?
ORM/Query	Prisma, Drizzle, SQLAlchemy, GORM?
Testing	Vitest, Jest, Pytest, Go test?
API Style	REST, GraphQL, gRPC?

Template

See

references/constraints.template.md

for the full constraints template.

Update Instructions File

After creating constraint files, update the project's AI instructions file to reference them:

1. Check for existing instructions file:

   • Look for

     CLAUDE.md

     (Claude Code) or

     AGENTS.md

     (Codex) in project root
   • If neither exists, create

     CLAUDE.md

2. Add reference section at the end of the file:

   ## Reference Documents
   
   The following constraint documents should be read before starting work:
   
   - `docs/reference/backend/constraints.md` - Tech stack and coding conventions
   

3. If file already has Reference Documents section: Append the new reference if not already present

Output

✓ Created docs/reference/backend/constraints.md
✓ Created docs/reference/backend/tasks/
✓ Updated CLAUDE.md with reference to constraint files
✓ Backend environment initialized

Key Rules

• ALWAYS use the unified header format
• MUST guide user through tech stack questions
• ALWAYS create tasks/ directory
• ALWAYS save to

  docs/reference/backend/constraints.md

• MUST update CLAUDE.md or AGENTS.md with reference to constraint files