Contributing

**Bug Report Template:**

## Description
Clear description of the bug

## Steps to Reproduce
1. Run command X
2. Observe error Y

## Expected Behavior
What should happen

## Actual Behavior
What actually happens

## Environment
- OS: macOS / Linux / Windows
- Buildforce version: v0.0.29
- AI Assistant: Cursor / Claude Code / etc.

**Feature Request Template:**

## Feature Description
What feature would you like?

## Use Case
Why is this feature needed?

## Proposed Solution
How might this work?

## Alternatives Considered
Other approaches you've thought about

git checkout -b feature/add-new-command
git checkout -b fix/pagination-bug
git checkout -b docs/improve-readme

# Research the codebase
/research how slash commands are implemented

# Define your spec
/spec Add /iterate command for plan refinement

# Build the feature
/build

# Complete and document
/complete

# Build
npm run build

# Link locally
npm link

# Test in a fresh project
cd ~/test-project
buildforce init .

# Test your changes
/research test query
/spec Test feature
/build
/complete

**PR Template:**

## Description
Brief description of what this PR does

## Related Issue
Closes #123

## Changes Made
- Added feature X
- Fixed bug Y
- Updated documentation Z

## Testing
- [ ] Tested locally with npm link
- [ ] All existing tests pass
- [ ] Added new tests for changes
- [ ] Documentation updated

## Checklist
- [ ] Code follows project style
- [ ] Commit messages are clear
- [ ] No breaking changes (or clearly documented)

# Features
git commit -m "feat: add /iterate command for plan refinement"

# Bug fixes
git commit -m "fix: resolve spec parsing error with YAML arrays"

# Documentation
git commit -m "docs: improve /research command examples"

# Refactoring
git commit -m "refactor: extract spec validation into separate module"

# Tests
git commit -m "test: add integration tests for /build command"

# Run all tests
npm test

# Run specific test file
npm test src/commands/research.test.ts

# Run with coverage
npm run test:coverage

describe('/research command', () => {
  it('should search context repository', async () => {
    const result = await research('authentication patterns');
    expect(result).toContain('authentication-module.yaml');
  });
});

buildforce-cli/
├── src/
│   ├── commands/          # Command implementations
│   │   ├── research.ts
│   │   ├── spec.ts
│   │   ├── build.ts
│   │   ├── complete.ts
│   │   └── document.ts
│   ├── templates/         # YAML templates
│   ├── scripts/           # Build and utility scripts
│   └── utils/             # Shared utilities
├── tests/                 # Test files
├── .starters/             # Command file templates
│   ├── claude/
│   ├── cursor/
│   └── ... (other AI assistants)
├── package.json
├── tsconfig.json
└── README.md