Field-hardening + project-capability routing + a prose readability pass - #2
Open
rmasl wants to merge 10 commits into
Open
Field-hardening + project-capability routing + a prose readability pass#2rmasl wants to merge 10 commits into
rmasl wants to merge 10 commits into
Conversation
…critique exit gate
…ocumented harness, round-trip economy, test-rerun scope
# Conflicts: # .claude/skills/speccy/DECISION_LOG.md # .claude/skills/speccy/SKILL.md
Discover a project's skills, research/hunter subagents, governing docs, and any routing hints once, as a precondition; persist the manifest to .speccy/<run-id>/capabilities.md at run creation; inject a phase-scoped "prefer these over generic approaches" block at every spawn site. All signals optional — absence degrades cleanly to the generic pipeline; routing needs no map because skills self-describe their triggers.
Breakdown gives each task the trigger-matched project skills as a "consult these before writing" list and pre-resolves placement/existence questions via the project's hunter agents — the executing agent can invoke a Skill but cannot dispatch an Agent. Execute activates the listed skills before writing and treats baked-in research findings as authoritative. Additive: with no capabilities present, both prompts behave as before.
Point first in every section, one idea per sentence, long sentences split, parenthetical asides unfolded, condition sets as bullets. Language-only: an independent fresh-context audit compared old vs new file by file — every rule, threshold, ordering, path, model assignment, gate, and exception survives; nothing lost, weakened, or invented. Code blocks, schemas, and frontmatter untouched.
Same language-only treatment as the speccy skill: point first, one idea per sentence, asides unfolded, conditions as bullets. Audit-confirmed rule-for-rule equivalent; the watchdog numerics and bash sketch survive byte for byte.
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.
Grown from real runs, in three layers — atomic commits, each with its DECISION_LOG entry.
1. Field-hardening (original scope)
worktree.baseRefself-heals tohead; a missing## Worktree initsection is synthesized from.gitignore+ the verify commands; sequential-only is the last resort.specs/<slug>-digest.md): goal, load-bearing decisions with one-line whys, build order, open risks — each item referencing the full spec's section. Digest first at the review gate.2. Lead with the project's own capabilities (new)
Discover once, as a precondition, what the project ships — skills, read-only research/"hunter" subagents, governing docs, any explicit skill→area map — into a manifest persisted at
.speccy/<run-id>/capabilities.md; inject a phase-scoped "prefer these over generic approaches" block at every spawn site. Spec/plan research delegates discovery to project hunters before generic sweeps; breakdown attaches trigger-matched skills to each task and pre-resolves placement/existence questions (a build agent can invoke a Skill but cannot dispatch an Agent); the local-doc lens judges against the house skill set. Everything optional: no required config artifact, clean degradation to the generic pipeline, and routing needs no map — skills self-describe their triggers.3. Prose readability pass (new)
Language-only rewrite of both skills' prose: point first in every section, one idea per sentence, long sentences split, parenthetical asides unfolded, condition sets as bullets. An independent fresh-context audit compared old vs new file by file — every rule, threshold, ordering, path, model assignment, gate, and exception survives; nothing lost, weakened, or invented. Code blocks (incl. the watchdog bash sketch, byte for byte), schemas, and frontmatter untouched.