claude-code/skills/programmer-add-project/SKILL.md

name, description, allowed-tools

name	description	allowed-tools
programmer-add-project	Register a new project with the programmer agent system. Use when adding a new codebase or project.	Bash Read Write

Add Project to Programmer Agent

Register a new project for context-aware code development.

Gather Information

Collect from the user:

1. Project path: Absolute path to project root
2. Project name: Short identifier (used for filename)
3. Description: What the project does (1-2 sentences)
4. Tech stack: Languages, frameworks, databases
5. Conventions: Path to conventions file or brief description

Validate

Before creating:

1. Verify the path exists: ls <path>
2. Check for existing project file: ~/.claude/state/programmer/projects/<name>.json
3. Look for conventions file if path provided

Create Project File

Write to ~/.claude/state/programmer/projects/<name>.json:

{
  "path": "/absolute/path/to/project",
  "description": "Description of the project",
  "stack": ["language", "framework", "database"],
  "conventions": "See CONTRIBUTING.md or brief description",
  "recentWork": [],
  "activeTodos": [],
  "created": "YYYY-MM-DD"
}

Output

Confirm to user:

## Project Registered

- **Name**: project-name
- **Path**: /path/to/project
- **Stack**: language, framework
- **Config**: `~/.claude/state/programmer/projects/project-name.json`

The programmer agent will now use this context when working in this project.

Example Interaction

User: "Add my inventory-api project"

Agent:

1. Ask for project path
2. Ask for description
3. Ask for tech stack
4. Look for CONTRIBUTING.md or conventions
5. Create project file
6. Confirm registration