Skip to content

feat(skills): enterprise-analyst rework of authoring skill prompts - #10

Open
ops-gaurav wants to merge 1 commit into
feat/review-skill-generate-outputfrom
feat/skill-prompt-improvements
Open

feat(skills): enterprise-analyst rework of authoring skill prompts#10
ops-gaurav wants to merge 1 commit into
feat/review-skill-generate-outputfrom
feat/skill-prompt-improvements

Conversation

@ops-gaurav

Copy link
Copy Markdown
Member

Summary

Reworks the phase-authoring skill prompts to behave like a senior analyst / architect / tech lead, across all three adapters (Anthropic, OpenAI Codex, Cursor — kept byte-consistent).

Four operating principles now run through the authoring skills:

  • Investigate before asking — explore the repo (manifests, related modules, tests) and research external services/libraries before asking the user anything
  • Ask informed questions, in one batch — 3–5 focused questions max, each with 2–3 concrete options and a recommended default
  • MVP first — P0 set alone must describe a shippable product; deferred ideas are recorded in Future Iterations, not dropped
  • Plain professional documents — readable by someone joining cold; inapplicable sections say why instead of filling boilerplate

Per-skill changes

Skill Change
spec-requirements Discovery step, batched gap questions, Summary / Goals & Non-Goals / Out of Scope & Future Iterations sections
spec-design Codebase-convention discovery, open decisions presented as option sets, Design Decisions record, Future Considerations, right-sized sections
spec-tasks Traceability table (F-XX/NF-XX → tasks), walking-skeleton Phase 1, S/M sizing, per-task Done when: criteria, testing inside each phase
spec-implement Fix: now reads design.md before building; orients on codebase conventions; verifies (tests + done criterion) before flipping checkboxes
spec-new Captures spec type + one-line summary, proposes kebab name, duplicate-spec check
spec-research Scouts ambiguous scope first, then asks batched informed questions
review checklists Updated for new structures; added MVP-fit and Fit & Simplicity groups

Also updates docs/generated-artifacts.md and normalizes Claude-specific tool names in the Cursor rules to generic phrasing.

Notes

🤖 Generated with Claude Code

Rework the phase-authoring skills around four operating principles:
investigate the repo before asking, research externals then ask batched
questions with options and a recommended default, MVP-first scoping with
recorded deferrals, and plain professionally structured documents.

- spec-requirements: discovery step (codebase + external research), batched
  gap questions, Summary / Goals & Non-Goals / Future Iterations sections,
  P0-set-is-shippable rule
- spec-design: discover codebase conventions first, present open decisions
  as option sets, Design Decisions record, Future Considerations,
  right-sized sections (N/A with reason)
- spec-tasks: traceability table (F-XX/NF-XX -> tasks), walking-skeleton
  Phase 1, S/M sizing, per-task "Done when:" criteria, testing inside
  each phase
- spec-implement: read design.md before building (was missing), orient on
  codebase conventions, verify (tests + lint + done criterion) before
  flipping checkboxes
- spec-new: capture spec type + one-line summary, propose kebab name,
  duplicate-spec check
- spec-research: scout ambiguous scope, then ask batched informed questions
- review checklists: updated for new structures; added MVP-fit and
  Fit & Simplicity groups
- docs/generated-artifacts.md: reflect new document shapes
- cursor rules: regenerated from skill bodies; normalized Claude-specific
  tool names to generic phrasing

Propagated identically to anthropic, openai-codex, and cursor adapters.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant