---
name: programmer-add-project
description: Register a new project with the programmer agent system. Use when adding a new codebase or project.
allowed-tools:
  - 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`:

```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:

```markdown
## 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