Implement a New Feature Safely

April 8, 2026 · View on GitHub

Use this when

You have a clear feature to build and want the full development workflow with enforced quality gates — from code to review to precommit.

Core skills

SkillRole
/feature-devOrchestrate the full development cycle
/verifyRun lint + typecheck + unit + integration tests
/codex-test-reviewReview test adequacy (mandatory)
/codex-review-fastDual code review (Codex + secondary)
/precommitFinal quality gate: lint + build + test
/update-docsSync docs with code changes

Command flow

  1. /feature-dev — starts the orchestrated workflow (or work manually step by step)
  2. Write code + tests for the feature
  3. /verify — run all tests, fix failures
  4. /codex-test-reviewmandatory test adequacy review; close gaps if needed with /codex-test-gen or /post-dev-test
  5. /codex-review-fast — dual code review (auto-loop: fix issues → re-review → pass)
  6. If code changed from review fixes: re-run /verify/codex-test-review --continue (freshness rule)
  7. /precommit — final gate after review passes
  8. /update-docs — sync tech spec and request docs (/create-request --update + /codex-review-doc if docs changed)
  9. /smart-commit --execute — commit when ready
  10. /push-ci — push and monitor CI

Decision points

SituationChoice
Test review finds gaps?/codex-test-gen for unit tests, /post-dev-test for integration
Code review finds P0/P1?Fix immediately → auto-loop re-reviews
Need architecture advice first?Start with /codex-architect before coding
Feature needs a tech spec?See Turn a request into a tech spec first

Gates

GateEnforced bySentinel
Code reviewHook + behavior✅ Ready / ⛔ Blocked
PrecommitHook✅ PASS / ❌ FAIL
Doc review (auto-triggered via doc-sync)Behavior✅ Mergeable / ⛔ Needs revision

Expected outcome

  • Feature implemented with tests
  • Code review passed (dual reviewer)
  • Precommit passed (lint + build + test)
  • Documentation synced
  • Ready to commit and push