Skip to content

Roadmap Tier 1 + 2: CI, templates, CONTRIBUTING, CHANGELOG, evaluator-pass skill, new-source-brief.sh, PUBLISHABLE tier, pre-commit#9

Merged
hnshah merged 1 commit into
mainfrom
claude/tier-1-2-roadmap
Apr 14, 2026
Merged

Roadmap Tier 1 + 2: CI, templates, CONTRIBUTING, CHANGELOG, evaluator-pass skill, new-source-brief.sh, PUBLISHABLE tier, pre-commit#9
hnshah merged 1 commit into
mainfrom
claude/tier-1-2-roadmap

Conversation

@hnshah
Copy link
Copy Markdown
Owner

@hnshah hnshah commented Apr 14, 2026

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 — runs doctor.sh and slop-check.sh on 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 the run → evaluator-pass → punch list → method change loop as the method-change pattern.
  • README.md — sharper public-facing hero. Leads with the core principle and a direct link to runs/vegan-dog-food-verdel/ as the canonical worked example.
  • v0.1.0 tag 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 existing pagekit-claim-checker subagent.
  • .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 into runs/<name>/sources/.
  • scripts/run-check.sh — new PUBLISHABLE tier above FULLY LOGGED. Requires claim-check.md filled in (not placeholder), first-page-draft.md filled 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 of slop-check and doctor. Opt-in (install with pre-commit install).
  • CHANGELOG.md — seeded with v0.1.0 (the current merged state, summarizing PRs Fix canonical chain drift and homepage defaults across the repo #1Clean-slate finish + public-readiness: remove high-trust test, add LICENSE + .gitignore #8) and [Unreleased] for this PR's additions.

Doctor updates

  • Includes the new subagent, the new skill, and new-source-brief.sh in its checks.

Deferred, flagged for you

Verification

  • CI on this PR passes (doctor.sh + slop-check.sh)
  • bash scripts/run-check.sh runs/vegan-dog-food-verdelPUBLISHABLE, exit 0
  • bash scripts/new-run.sh _verify && bash scripts/run-check.sh runs/_verify → FULLY LOGGED (not PUBLISHABLE) with clear upgrade path
  • bash scripts/new-run.sh _sbtest && bash scripts/new-source-brief.sh _sbtest mechanism scaffolds runs/_sbtest/sources/02-mechanism-brief.md
  • Skim CONTRIBUTING.md, CHANGELOG.md, and the new PR + issue templates

Next move after merge

  1. Tag v0.1.0 and push the tag (I'll handle this from my side once merged).
  2. Real-object run(s) — tell me the objects and I'll run /pagekit.

…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
@hnshah hnshah merged commit 306a234 into main Apr 14, 2026
1 check passed
@hnshah hnshah deleted the claude/tier-1-2-roadmap branch April 15, 2026 02:16
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.

2 participants