feat(skills): enterprise-analyst rework of authoring skill prompts - #10
Open
ops-gaurav wants to merge 1 commit into
Open
feat(skills): enterprise-analyst rework of authoring skill prompts#10ops-gaurav wants to merge 1 commit into
ops-gaurav wants to merge 1 commit into
Conversation
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
Per-skill changes
spec-requirementsspec-designspec-tasksDone when:criteria, testing inside each phasespec-implementdesign.mdbefore building; orients on codebase conventions; verifies (tests + done criterion) before flipping checkboxesspec-newspec-researchAlso updates
docs/generated-artifacts.mdand normalizes Claude-specific tool names in the Cursor rules to generic phrasing.Notes
feat/review-skill-generate-output) — the review-file/revise content these prompts reference lives there. Retarget tomainafter feat(spec-review, spec-revise): emit review file + add revise skill #9 merges.approve,status,switch,update-task,sync) unchanged;spec-syncparsing format untouched..mdcbodies regenerated from skill bodies.🤖 Generated with Claude Code