Backend Init Skill | Agent Skills

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

Check existing: Look for docs/reference/backend/constraints.md
If exists: Ask user if they want to overwrite or skip

Create directory structure:

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

Generate constraints file:
- Read template from references/constraints.template.md
- Guide user through key decisions
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:

Check for existing instructions file:
- Look for CLAUDE.md (Claude Code) or AGENTS.md (Codex) in project root
- If neither exists, create CLAUDE.md

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

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

Agent Skills: Backend Init

Install this agent skill to your local

Skill Files