Roadmap Tier 1 + 2: CI, templates, CONTRIBUTING, CHANGELOG, evaluator-pass skill, new-source-brief.sh, PUBLISHABLE tier, pre-commit#9
Merged
Conversation
…skill+agent, new-source-brief.sh, PUBLISHABLE tier, pre-commit Ships 11 of the 13 Tier 1+2 items from the roadmap. Two items (#2 and #9, real-object runs) need objects from the user and are flagged for a follow-up. Tier 1 (high leverage, small effort): - .github/workflows/check.yml: runs doctor.sh and slop-check.sh on every push and PR. - .github/PULL_REQUEST_TEMPLATE.md: matches the repo's actual PR rhythm. - .github/ISSUE_TEMPLATE/{method-feedback,bug,method-proposal}.md - CONTRIBUTING.md: four shapes of contribution, required checks, what bad contribution looks like. - README.md: sharper public hero. Points at runs/vegan-dog-food-verdel/ as the canonical worked example. Leads with the core principle instead of a feature list. - (v0.1.0 tag will be pushed after this PR merges.) Tier 2 (high leverage, medium effort): - .claude/agents/pagekit-evaluator-pass.md: read-only subagent for the adversarial evaluator pass. Produces runs/<name>/evaluator-pass.md. - .claude/skills/pagekit-evaluator-pass/SKILL.md: skill wrapper that delegates to the subagent. - scripts/new-source-brief.sh: scaffold a single source brief (wedge / mechanism / proof / comparison). Auto-numbered; reads the canonical brief templates; matches the Verdel sources/ pattern. - scripts/run-check.sh: new PUBLISHABLE tier above FULLY LOGGED. Requires claim-check.md filled in (not placeholder), first-page-draft.md filled in (not placeholder), and slop-check clean on the draft(s). Verdel now classifies as PUBLISHABLE; empty scaffolds classify as FULLY LOGGED with a clear punch list. - .pre-commit-config.yaml: local enforcement of slop-check + doctor on every commit. Optional (contributors opt in with pre-commit install). - CHANGELOG.md: seeded with v0.1.0 (the current merged state) and [Unreleased] for this PR's additions. Related: - scripts/doctor.sh updated to include the new subagent, the new skill, and scripts/new-source-brief.sh in its manifest checks. Deferred (need user input): - Tier 1 #2 and Tier 2 #9: real-object runs (non-fictional). Requires an object from the user. Flagged in the handoff. Verified: - scripts/doctor.sh PASS - scripts/slop-check.sh exit 0 clean - scripts/run-check.sh runs/vegan-dog-food-verdel -> PUBLISHABLE - scripts/run-check.sh runs/<fresh-scaffold> -> FULLY LOGGED (not PUBLISHABLE) - scripts/new-source-brief.sh smoke test created mechanism brief - scripts/new-run.sh still scaffolds correctly with doctor.sh post-change
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.
Ships 11 of the 13 Tier 1 + Tier 2 items from the roadmap discussion. Two items (real-object runs) need objects from you and are flagged at the bottom.
What's in
Tier 1 (high leverage, small effort)
.github/workflows/check.yml— runsdoctor.shandslop-check.shon every push and PR. First thing a public-repo visitor checks is whether CI is green..github/PULL_REQUEST_TEMPLATE.md— matches the repo's actual PR rhythm (summary / what changed / verification / test plan)..github/ISSUE_TEMPLATE/— three templates:method-feedback(I used PageKit),bug(tooling misbehaving),method-proposal(change the chain).CONTRIBUTING.md— four shapes of contribution, required checks, what bad contribution looks like. Cites therun → evaluator-pass → punch list → method changeloop as the method-change pattern.README.md— sharper public-facing hero. Leads with the core principle and a direct link toruns/vegan-dog-food-verdel/as the canonical worked example.v0.1.0tag and GitHub release will be pushed after this PR merges.Tier 2 (high leverage, medium effort)
.claude/agents/pagekit-evaluator-pass.md— read-only subagent for the adversarial evaluator pass. Parallel to the existingpagekit-claim-checkersubagent..claude/skills/pagekit-evaluator-pass/SKILL.md— user-invocable skill wrapper. Delegates to the subagent.scripts/new-source-brief.sh— scaffolds a single source brief (wedge/mechanism/proof/comparison) on demand. Auto-numbered to slot intoruns/<name>/sources/.scripts/run-check.sh— new PUBLISHABLE tier above FULLY LOGGED. Requiresclaim-check.mdfilled in (not placeholder),first-page-draft.mdfilled in, and slop-check clean on the drafts.runs/vegan-dog-food-verdel/now classifies as PUBLISHABLE; empty scaffolds classify as FULLY LOGGED with a clear punch list..pre-commit-config.yaml— local enforcement ofslop-checkanddoctor. Opt-in (install withpre-commit install).CHANGELOG.md— seeded withv0.1.0(the current merged state, summarizing PRs Fix canonical chain drift and homepage defaults across the repo #1–Clean-slate finish + public-readiness: remove high-trust test, add LICENSE + .gitignore #8) and[Unreleased]for this PR's additions.Doctor updates
new-source-brief.shin its checks.Deferred, flagged for you
Verification
doctor.sh+slop-check.sh)bash scripts/run-check.sh runs/vegan-dog-food-verdel→ PUBLISHABLE, exit 0bash scripts/new-run.sh _verify && bash scripts/run-check.sh runs/_verify→ FULLY LOGGED (not PUBLISHABLE) with clear upgrade pathbash scripts/new-run.sh _sbtest && bash scripts/new-source-brief.sh _sbtest mechanismscaffoldsruns/_sbtest/sources/02-mechanism-brief.mdCONTRIBUTING.md,CHANGELOG.md, and the new PR + issue templatesNext move after merge
v0.1.0and push the tag (I'll handle this from my side once merged)./pagekit.