Skip to main content

Getting Started for Developers

Build features from specs using Claude Code commands.

Prerequisites​

Workflow​

1. Get notified of new specs​

When PM/BA creates or updates docs/<feature>/spec.md, you'll get a notification (Slack/PR comment).

2. Develop the feature​

# In Claude Code, run:
/develop-feature <feature-name>

This command:

  • Reads docs/<feature>/spec.md (required)
  • Reads example data in docs/<feature>/examples/
  • Creates an implementation plan
  • Builds the feature step-by-step

3. Fix issues​

/fix-issue "user cannot login after password reset"

Or with a GitHub issue link:

/fix-issue https://github.com/quochuydev/workflow/issues/123

4. Understand code flow​

/trace-flow handleLogin

This traces the code path and shows related business rules from docs.

Available Commands​

CommandPurpose
/develop-feature <name>Build feature from spec
/fix-issue <desc>Fix bug with doc context
/trace-flow <target>Trace code with business rules

Example​

See a working example: github.com/quochuydev/workflow/tree/main/examples

Tips​

  • Always check docs first - If something is unclear, ask PM/BA to update the spec
  • Validate against docs - After building, verify your code matches all acceptance criteria
  • Don't assume - If the spec doesn't say it, ask before implementing