feature-work git:20260719.df80540A

Immutable. This exact content is served forever at /api/v1/blob/194a6d6ef520f730.

---
name: feature-work
description: Standard workflow for implementing new features with testing
---

# Feature Work

When implementing a new feature:

## 1. Understand Requirements
- Read the Linear/GitHub issue thoroughly
- Check for an associated PRD draft at `<projectRoot>/.pan/drafts/<ISSUE-ID>.md` and the workspace xBRIEF at `.pan/spec.vbrief.json`
- Identify acceptance criteria
- Clarify ambiguities BEFORE coding

## 2. Design Approach
- Identify files that need changes
- Consider existing patterns in codebase
- Plan implementation (don't gold-plate)

## 3. Implement
- Follow existing code conventions
- Make atomic, focused commits
- Keep changes scoped to the issue
- Commit format: `feat: description (ISSUE-XXX)`

## 4. Test
- Add tests for new functionality
- Run full test suite
- All tests must pass before proceeding

## 5. Self-Review
- Review your diff: `git diff origin/main...HEAD`
- Check for: bugs, security issues, style, cruft
- Fix issues found (don't just note them)

## 6. Submit
- Push branch: `git push -u origin $(git branch --show-current)`
- Create MR/PR with clear description