docs(evolve): bake fix-and-repush discipline into the /evolve skill (ag-j4l1 #evolve-discipline-references)#615
Merged
Merged
Conversation
…ll (ag-j4l1) Promotes this session's throwaway cron-prompt discipline into the durable skill so every future run inherits it (the cron prompt is session-only). - NEW references/new-skill-landing.md: the SIX derived surfaces a new/modified skill must regenerate in one shot (registry.json being the most-missed), with the regen-all.sh shortcut + the manual codex-twin/SKILL-TIERS steps. - gate-hygiene.md +2 subsections: pre-push diff-scope check (catches half-staged commits + conflict-resolution collateral deletions) and pre-existing-vs-mine red triage (mkdocs-strict + the 7 codex artifact drifts). - SKILL.md links both from Step 4.5 + the References list (heal --strict clean). Built one-shot through its own discipline: codex twin hash refreshed for evolve, 7 pre-existing drifts reverted, manifest rebuilt to the evolve delta only. Closes-scenario: ag-j4l1#evolve-discipline-references Bounded-context: BC2-Validation Evidence: tests/scripts/evolve-discipline-references.bats (4/4); heal --strict skills/evolve clean; validate-codex-generated-artifacts --scope worktree pass
contracts-sync + correctness(ubuntu) were red on a stale registry.json — the evolve skill's content hash shifted when its SKILL.md/references changed. Ran generate-registry.sh (80 skills, 162 SKU capabilities); --check now OK. Fittingly, this is the exact lesson the PR documents (registry.json is the most-missed surface) — caught and fixed via the very discipline being baked in. ag-j4l1
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
1 participant
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.
What
Promotes this session's hard-won fix-and-repush discipline — which lived only in the session-only cron prompt (expires in 7 days) — into the durable
/evolveskill, so every future autonomous run inherits it.How
skills/evolve/references/new-skill-landing.md— the six derived surfaces a new/modified skill must regenerate in one shot (registry.json being the most-missed; it tripscontracts-sync+correctness(ubuntu)together), with theregen-all.shshortcut and the manual codex-twin /SKILL-TIERS.mdsteps.gate-hygiene.md+2 subsections: pre-push diff-scope check (catches half-staged commits like chore(tests): codex-desc budget is per-skill-average, not a hard aggregate (ag-vzbt) #612 + conflict-resolution collateral deletions like feat(skills): add /burndown — bounded epic-completion loop (ag-3yl8 #burndown-skill) #600) and pre-existing-vs-mine red triage (mkdocs-strict + the 7 codex.agentops-generated.jsondrifts).SKILL.mdlinks both from Step 4.5 + the References list.Dog-fooding
Built one-shot through its own documented discipline: codex twin hash refreshed for
evolve, the 7 pre-existing codex drifts reverted, manifest surgically rebuilt to theevolvedelta only. No inventory/count files touched (correct — adds references, not a skill).Evidence
tests/scripts/evolve-discipline-references.bats→ 4/4 (locks both reference links + the two new gate-hygiene subsections)heal.sh --strict skills/evolve→ cleanvalidate-codex-generated-artifacts.sh --scope worktree→ pass(Companion: ag-cw2y wired the skill-builder scaffold; ag-ekyq added the registry surface; this bakes the operator-side runtime guidance into /evolve.)
Closes-scenario: ag-j4l1#evolve-discipline-references
Bounded-context: BC2-Validation
Evidence: skills/evolve/references/new-skill-landing.md