formwork-kit 1.0.0__tar.gz → 1.0.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- formwork_kit-1.0.1/CHANGELOG.md +157 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/FORMWORK.md +26 -1
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/PKG-INFO +10 -7
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/README.md +9 -6
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/COSTS.md +11 -10
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/adapters/codex/README.md +18 -7
- formwork_kit-1.0.1/formwork/bring-a-skill.md +113 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/doc-links +1 -1
- formwork_kit-1.0.1/formwork/check/checks/gates +219 -0
- formwork_kit-1.0.1/formwork/check/checks/guard-wired +158 -0
- formwork_kit-1.0.1/formwork/check/checks/hidden-unicode +217 -0
- formwork_kit-1.0.1/formwork/check/checks/kit-leak-scan +262 -0
- formwork_kit-1.0.1/formwork/check/checks/predictions-first +208 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/role-shape +1 -1
- formwork_kit-1.0.1/formwork/check/checks/roles-named +212 -0
- formwork_kit-1.0.1/formwork/check/checks/skill-provenance +142 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/standing-current +95 -2
- formwork_kit-1.0.1/formwork/check/checks/task-size +225 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/work-paired +60 -8
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/a-decision-not-written/docs/briefs/0002-storage.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/a-decision-not-written/docs/decisions/0001-one-database.md +7 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/a-gate-in-prose/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/a-gate-in-prose/docs/briefs/0002-build.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/after-a-stream-all-dropped/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/after-a-stream-all-dropped/docs/briefs/0002-build.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/after-a-stream-nobody-named/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/after-a-stream-nobody-named/docs/briefs/0002-build.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/after-a-stream-nobody-named/docs/reports/0001-spec.md +12 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/after-a-stream-still-open/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/after-a-stream-still-open/docs/briefs/0002-build.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/build-before-the-spec-is-accepted/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/build-before-the-spec-is-accepted/docs/briefs/0002-build.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/build-before-the-spec-is-accepted/docs/reports/0001-spec.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/two-gates-on-one-brief/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/two-gates-on-one-brief/docs/briefs/0002-build.md +10 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/two-gates-on-one-brief/docs/reports/0001-spec.md +12 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-fail/waits-on-its-own-stream/docs/briefs/0001-build.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/a-dropped-brief-does-not-hold-the-gate/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/a-dropped-brief-does-not-hold-the-gate/docs/briefs/0002-second-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/a-dropped-brief-does-not-hold-the-gate/docs/briefs/0003-build.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/a-dropped-brief-does-not-hold-the-gate/docs/reports/0001-spec.md +12 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/after-a-decision-that-exists/docs/briefs/0004-storage.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/after-a-decision-that-exists/docs/briefs/0005-search.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/after-a-decision-that-exists/docs/decisions/0003-one-database.md +7 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/build-after-an-accepted-spec/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/build-after-an-accepted-spec/docs/briefs/0002-build.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/build-after-an-accepted-spec/docs/reports/0001-spec.md +12 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/closed-briefs-are-history/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/closed-briefs-are-history/docs/briefs/0002-spike.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/closed-briefs-are-history/docs/reports/0002-spike.md +12 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/no-gate-is-no-gate/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/starts-now/docs/briefs/0001-spec.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/two-streams-side-by-side/docs/briefs/0001-spec.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/two-streams-side-by-side/docs/briefs/0002-review.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/two-streams-side-by-side/docs/briefs/0003-redesign.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/gates/must-pass/two-streams-side-by-side/docs/reports/0001-spec.md +12 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-fail/codex-file-claims-without-list/.codex/hooks.json +1 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-fail/codex-file-not-wired/.codex/hooks.json +15 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-fail/codex-file-not-wired/.formwork.toml +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-fail/codex-matcher-misses-patch/.claude/settings.json +1 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-fail/codex-matcher-misses-patch/.codex/hooks.json +19 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-fail/codex-matcher-misses-patch/.formwork.toml +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-fail/runtimes-lists-codex-no-file/.formwork.toml +2 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-pass/claude-and-codex-wired/.claude/settings.json +1 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-pass/claude-and-codex-wired/.codex/hooks.json +19 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-pass/claude-and-codex-wired/.formwork.toml +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired/.claude/settings.json +1 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-fail/a-bidi-override/formwork/rules/core.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-fail/a-byte-order-mark-mid-file/formwork/style.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-fail/a-generated-role/.claude/agents/reviewer.md +4 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-fail/a-zero-width-space/formwork/roles/method/writer.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-fail/tag-characters/FORMWORK.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-pass/a-clean-kit/FORMWORK.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-pass/a-clean-kit/formwork/roles/method/writer.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-pass/byte-order-mark-at-start/formwork/style.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-pass/emoji-and-accents/formwork/taste/README.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-pass/project-files-not-read/.claude/agents/our-own.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-pass/project-files-not-read/docs/notes.md +1 -0
- formwork_kit-1.0.1/formwork/check/fixtures/hidden-unicode/must-pass/project-files-not-read/formwork/loop.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-fail/a-generated-role/.claude/agents/lead.md +6 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-fail/a-home-path/formwork/first-run.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-fail/a-local-hostname/FORMWORK.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-fail/a-private-address/formwork/models.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-fail/a-tailscale-address/formwork/remote.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-fail/an-api-key/formwork/adapters/notes.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-fail/an-email/formwork_cli/__init__.py +2 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-pass/a-hand-written-agent/.claude/agents/mine.md +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-pass/a-hand-written-agent/formwork/page.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-pass/a-leak-outside-the-kit/docs/notes.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-pass/a-leak-outside-the-kit/formwork/page.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/kit-leak-scan/must-pass/placeholders/formwork/page.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-fail/a-challenger-argued-beside-the-research/docs/research/a-journeys.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-fail/a-challenger-argued-beside-the-research/docs/research/b-platform.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-fail/a-challenger-argued-beside-the-research/docs/research/challenge.md +4 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-fail/a-round-folder-inside-the-design-work/docs/design/round-2/challenger.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-fail/a-round-folder-inside-the-design-work/docs/design/round-2/concept.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-pass/predictions-beside-the-research-lanes/docs/research/a-journeys.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-pass/predictions-beside-the-research-lanes/docs/research/challenge.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-pass/predictions-beside-the-research-lanes/docs/research/predictions.md +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-pass/predictions-inside-the-challenge/docs/design/challenge.md +12 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-pass/predictions-named-for-the-role/docs/design/the-assistant/rounds/challenger-predictions.md +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-pass/predictions-named-for-the-role/docs/design/the-assistant/rounds/r1-architect.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/predictions-first/must-pass/predictions-named-for-the-role/docs/design/the-assistant/rounds/r1-challenger.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-brief-team-for-no-role/docs/rounds/cache/brief.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-brief-team-for-no-role/docs/rounds/cache/predictions.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-brief-team-for-no-role/formwork/roles/architect.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-brief-team-for-no-role/formwork/roles/challenger.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-file-for-no-role/docs/rounds/pricing/architect.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-file-for-no-role/docs/rounds/pricing/brief.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-file-for-no-role/docs/rounds/pricing/challenger.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-file-for-no-role/docs/rounds/pricing/creative-director.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-file-for-no-role/docs/rounds/pricing/predictions.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-file-for-no-role/formwork/roles/architect.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-round-file-for-no-role/formwork/roles/challenger.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-team-row-for-no-role/docs/briefs/0002-launch.md +12 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-team-row-for-no-role/formwork/roles/lead.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-fail/a-team-row-for-no-role/formwork/roles/visual.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-project-role-and-a-closed-brief/docs/briefs/0001-old.md +11 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-project-role-and-a-closed-brief/docs/briefs/0004-sound.md +12 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-project-role-and-a-closed-brief/formwork/roles/project/sound-designer.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-project-role-and-a-closed-brief/formwork/roles/writer.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-round-of-real-roles/docs/rounds/storage/architect.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-round-of-real-roles/docs/rounds/storage/brief.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-round-of-real-roles/docs/rounds/storage/challenger-second-pass.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-round-of-real-roles/docs/rounds/storage/predictions.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-round-of-real-roles/docs/rounds/storage/record-keeper.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-round-of-real-roles/docs/rounds/storage/round.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-round-of-real-roles/formwork/roles/architect.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-round-of-real-roles/formwork/roles/challenger.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-round-of-real-roles/formwork/roles/record-keeper.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-team-with-a-relabel/docs/briefs/0003-the-look.md +17 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-team-with-a-relabel/formwork/roles/lead.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/roles-named/must-pass/a-team-with-a-relabel/formwork/roles/visual.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/a-branch-not-a-commit/.claude/skills/sample/LICENSE +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/a-branch-not-a-commit/.claude/skills/sample/SKILL.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/a-branch-not-a-commit/.claude/skills/sample/UPSTREAM.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/copied-by-hand-no-record/.claude/skills/sample/SKILL.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/edited-after-recording/.claude/skills/sample/LICENSE +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/edited-after-recording/.claude/skills/sample/SKILL.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/edited-after-recording/.claude/skills/sample/UPSTREAM.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/kit-skill-with-no-record/formwork/skills/sample/LICENSE +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/kit-skill-with-no-record/formwork/skills/sample/SKILL.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/no-licence/.claude/skills/sample/SKILL.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-fail/no-licence/.claude/skills/sample/UPSTREAM.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/a-kit-skill-and-its-generated-copy/.claude/skills/sample/SKILL.md +7 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/a-kit-skill-and-its-generated-copy/formwork/skills/sample/LICENSE +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/a-kit-skill-and-its-generated-copy/formwork/skills/sample/SKILL.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/a-kit-skill-and-its-generated-copy/formwork/skills/sample/UPSTREAM.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/a-traced-project-skill/.claude/skills/sample/LICENSE +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/a-traced-project-skill/.claude/skills/sample/SKILL.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/a-traced-project-skill/.claude/skills/sample/UPSTREAM.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/no-skills/docs/README.md +1 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/written-here/.claude/skills/ours/SKILL.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/skill-provenance/must-pass/written-here/.claude/skills/ours/UPSTREAM.md +1 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-fail/a-report-is-newer-than-the-brief/docs/briefs/0002-page-size.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-fail/a-report-is-newer-than-the-brief/docs/reports/0002-page-size.md +7 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-fail/a-report-is-newer-than-the-brief/docs/standing.md +29 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-fail/accepted-after-the-brief-was-written/docs/briefs/0002-page-size.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-fail/accepted-after-the-brief-was-written/docs/reports/0002-page-size.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-fail/accepted-after-the-brief-was-written/docs/standing.md +29 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-fail/next-names-a-brief-already-done/docs/briefs/0001-research.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-fail/next-names-a-brief-already-done/docs/reports/0001-research.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-fail/next-names-a-brief-already-done/docs/standing.md +29 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-pass/ahead-of-the-briefs-and-reports/docs/briefs/0001-research.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-pass/ahead-of-the-briefs-and-reports/docs/briefs/0002-page-size.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-pass/ahead-of-the-briefs-and-reports/docs/briefs/0003-second-size.md +9 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-pass/ahead-of-the-briefs-and-reports/docs/reports/0001-research.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-pass/ahead-of-the-briefs-and-reports/docs/reports/0002-page-size.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-pass/ahead-of-the-briefs-and-reports/docs/standing.md +29 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-pass/undated-work-is-counted-not-compared/docs/briefs/0001-slow-login.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-pass/undated-work-is-counted-not-compared/docs/reports/0001-slow-login.md +3 -0
- formwork_kit-1.0.1/formwork/check/fixtures/standing-current/must-pass/undated-work-is-counted-not-compared/docs/standing.md +29 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-fail/a-long-brief-with-no-size/docs/briefs/0004-faster-search.md +27 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-fail/a-one-line-brief-whose-report-lists-many-files/docs/briefs/0007-rename-flag.md +6 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-fail/a-one-line-brief-whose-report-lists-many-files/docs/reports/0007-rename-flag.md +14 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-fail/a-page-written-as-long-lines/docs/briefs/0009-onboarding.md +11 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-fail/a-short-report-that-lists-many-files-bare/docs/briefs/0003-typo.md +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-fail/a-short-report-that-lists-many-files-bare/docs/reports/0003-typo.md +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-fail/a-size-nobody-can-read/docs/briefs/0002-billing.md +6 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-pass/a-long-brief-already-closed/docs/briefs/0004-faster-search.md +26 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-pass/a-long-brief-already-closed/docs/reports/0004-faster-search.md +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-pass/a-long-brief-that-says-its-size/docs/briefs/0004-faster-search.md +27 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-pass/a-one-line-task/docs/briefs/0001-rename.md +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-pass/a-one-line-task/docs/reports/0001-rename.md +6 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-pass/files-read-are-not-files-changed/docs/briefs/0006-fix-date.md +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-pass/files-read-are-not-files-changed/docs/reports/0006-fix-date.md +11 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-pass/no-briefs-at-all/README.md +1 -0
- formwork_kit-1.0.1/formwork/check/fixtures/task-size/must-pass/the-size-said-in-the-body/docs/briefs/0005-faster-search.md +28 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-fail/one-word-read-back-by-default/docs/reports/0001-slow-login.md +18 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-fail/streams-written-but-not-declared/docs/briefs/0101-split-the-engine.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-fail/streams-written-but-not-declared/docs/briefs/0201-the-runner.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-fail/two-open-in-one-stream/.formwork.toml +6 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-fail/two-open-in-one-stream/docs/briefs/0101-split-the-engine.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-fail/two-open-in-one-stream/docs/briefs/0102-engine-tests.md +7 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-fail/two-open-in-one-stream/docs/briefs/0201-the-runner.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/one-open-in-each-stream/.formwork.toml +6 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/one-open-in-each-stream/docs/briefs/0001-requirements.md +7 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/one-open-in-each-stream/docs/briefs/0101-split-the-engine.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/one-open-in-each-stream/docs/briefs/0201-the-runner.md +8 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/one-open-in-each-stream/docs/briefs/0301-the-name.md +7 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/read-back-lowered-to-one/.formwork.toml +5 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/read-back-lowered-to-one/docs/briefs/0001-slow-login.md +18 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/read-back-lowered-to-one/docs/reports/0001-slow-login.md +18 -0
- formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine/docs/briefs/0001-slow-login.md +18 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/run +3 -1
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/test_gate.py +88 -0
- formwork_kit-1.0.1/formwork/evals/guards/protected-files.json +24 -0
- formwork_kit-1.0.1/formwork/evals/guards/run +374 -0
- formwork_kit-1.0.1/formwork/evals/routing/prompts.json +442 -0
- formwork_kit-1.0.1/formwork/evals/routing/run +204 -0
- formwork_kit-1.0.1/formwork/evals/routing/standing.md +25 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/glossary.md +32 -2
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/guard/protected-files +151 -4
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/guard/test_protection.py +140 -2
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/limits.md +73 -4
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/loop.md +44 -0
- formwork_kit-1.0.1/formwork/measure-a-guard.md +102 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/HOW-TO-ADD-A-ROLE.md +6 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/TEMPLATE.md +3 -1
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/method/director.md +60 -2
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/method/lead.md +68 -1
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/frontend.md +4 -2
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/mobile.md +4 -2
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/visual.md +3 -2
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/writer.md +4 -2
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/round.md +2 -1
- formwork_kit-1.0.1/formwork/route.md +182 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/rules/core.md +3 -2
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/setup +73 -4
- formwork_kit-1.0.1/formwork/taste/README.md +112 -0
- formwork_kit-1.0.1/formwork/taste/deck.md +70 -0
- formwork_kit-1.0.1/formwork/taste/ios.md +85 -0
- formwork_kit-1.0.1/formwork/taste/motion.md +265 -0
- formwork_kit-1.0.1/formwork/taste/screens.md +91 -0
- formwork_kit-1.0.1/formwork/taste/web.md +117 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/templates/brief.md +19 -0
- formwork_kit-1.0.1/formwork/templates/build.md +60 -0
- formwork_kit-1.0.1/formwork/templates/design-round.md +50 -0
- formwork_kit-1.0.1/formwork/templates/personal-defaults.md +40 -0
- formwork_kit-1.0.1/formwork/templates/project-instructions.md +16 -0
- formwork_kit-1.0.1/formwork/templates/release-step.md +56 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/templates/report.md +2 -1
- formwork_kit-1.0.1/formwork/templates/research-lane.md +50 -0
- formwork_kit-1.0.1/formwork/templates/review-round.md +80 -0
- formwork_kit-1.0.1/formwork/templates/routing.md +26 -0
- formwork_kit-1.0.1/formwork/templates/spec.md +58 -0
- formwork_kit-1.0.1/formwork/templates/upstream.md +43 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/test_setup.py +36 -6
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/pyproject.toml +1 -1
- formwork_kit-1.0.0/CHANGELOG.md +0 -50
- formwork_kit-1.0.0/formwork/check/checks/guard-wired +0 -139
- formwork_kit-1.0.0/formwork/check/checks/predictions-first +0 -127
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/.gitignore +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/LICENSE +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/adapters/claude-code/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/adapters/claude-code/settings.json +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/adapters/cursor/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/adapters/gemini-cli/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/build +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/config-shape +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/decision-ids +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/generated-current +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/kit-integrity +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/report-shape +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/rule-labels +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/checks/style-pointed +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/config-shape/must-fail/documents-a-section-that-does-not-exist/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/config-shape/must-fail/documents-a-section-that-does-not-exist/formwork/guide.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/config-shape/must-fail/rules-as-a-switchboard/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/config-shape/must-pass/layers-kept-apart/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/decision-ids/must-fail/a-placeholder-shipped/docs/decisions/0003-still-pending.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/decision-ids/must-fail/superseded-by-nothing/docs/decisions/0002-old.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/decision-ids/must-fail/two-decisions-one-number/docs/decisions/0007-first.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/decision-ids/must-fail/two-decisions-one-number/docs/decisions/0007-second.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/decision-ids/must-pass/clean-numbering/docs/decisions/0001-the-first.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/decision-ids/must-pass/clean-numbering/docs/decisions/0002-the-second.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/decision-ids/must-pass/clean-numbering/docs/decisions/0003-the-third.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/decision-ids/must-pass/nothing-recorded-yet/docs/decisions/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/doc-links/must-fail/never-written/index.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/doc-links/must-fail/renamed-file/architecture-notes.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/doc-links/must-fail/renamed-file/guide.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/doc-links/must-pass/links-resolve/architecture-notes.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/doc-links/must-pass/links-resolve/guide.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.claude/agents/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.codex/agents/sample.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.gemini/agents/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/formwork/build +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/formwork/roles/method/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.claude/agents/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.codex/agents/sample.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.gemini/agents/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/formwork/build +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/formwork/roles/method/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.claude/agents/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.codex/agents/sample.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.gemini/agents/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/formwork/build +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/formwork/roles/method/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.claude/agents/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.codex/agents/sample.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.gemini/agents/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/formwork/build +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/formwork/roles/method/sample.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/generated-current/must-pass/nothing-is-generated-here/README.md +0 -0
- {formwork_kit-1.0.0/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired → formwork_kit-1.0.1/formwork/check/fixtures/guard-wired/must-fail/codex-file-not-wired}/.claude/settings.json +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/guard-wired/must-fail/declared-but-no-file/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/guard-wired/must-fail/file-but-not-wired/.claude/settings.json +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/guard-wired/must-fail/file-but-not-wired/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/guard-wired/must-pass/nothing-declared/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/kit-integrity/must-fail/a-check-went-missing/formwork/check/checks/still-here +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/kit-integrity/must-fail/a-check-went-missing/state/fingerprints.txt +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/kit-integrity/must-fail/a-guard-was-altered/formwork/guard/git-boundary +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/kit-integrity/must-fail/a-guard-was-altered/state/fingerprints.txt +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/kit-integrity/must-pass/everything-matches/formwork/guard/git-boundary +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/kit-integrity/must-pass/everything-matches/state/fingerprints.txt +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/predictions-first/must-fail/argued-with-no-predictions/docs/rounds/0004-the-storage-question/architect.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/predictions-first/must-fail/argued-with-no-predictions/docs/rounds/0004-the-storage-question/researcher.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/predictions-first/must-fail/argued-with-no-predictions/docs/rounds/0004-the-storage-question/round.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/predictions-first/must-pass/a-round-that-has-not-argued-yet/docs/rounds/0006-not-started/round.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/predictions-first/must-pass/no-rounds-at-all/docs/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/predictions-first/must-pass/predictions-on-record/docs/rounds/0005-the-shape-of-a-brief/architect.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/predictions-first/must-pass/predictions-on-record/docs/rounds/0005-the-shape-of-a-brief/predictions.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/predictions-first/must-pass/predictions-on-record/docs/rounds/0005-the-shape-of-a-brief/researcher.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/report-shape/must-fail/a-command-in-the-human-part/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/report-shape/must-fail/no-part-for-the-human/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/report-shape/must-fail/over-the-ceiling/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/report-shape/must-fail/the-director-comes-first/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/report-shape/must-pass/a-bridge-written-before-the-rule/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/report-shape/must-pass/no-reports-folder/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/report-shape/must-pass/the-task-version/docs/reports/0002-rename-foo.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/report-shape/must-pass/two-parts-in-order/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/role-shape/must-fail/claims-a-grant-binds-everywhere/formwork/roles/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/role-shape/must-fail/claims-a-grant-binds-everywhere/formwork/roles/complete.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/role-shape/must-fail/missing-a-section/formwork/roles/vague.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/role-shape/must-fail/spawn-without-being-lead/formwork/roles/eager.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/role-shape/must-fail/two-roles-one-job/formwork/roles/first.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/role-shape/must-fail/two-roles-one-job/formwork/roles/second.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/role-shape/must-pass/well-formed/formwork/roles/complete.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/rule-labels/must-fail/claims-enforcement-that-does-not-exist/formwork/rules/core.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/rule-labels/must-fail/no-catches/formwork/rules/core.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/rule-labels/must-fail/unlabelled/formwork/rules/core.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/rule-labels/must-pass/well-formed/formwork/rules/core.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-fail/a-decision-hides-in-a-subfolder/docs/decisions/2026/0002-second-page-size.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-fail/a-decision-hides-in-a-subfolder/docs/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-fail/a-decision-is-newer-than-the-brief/docs/decisions/0002-second-page-size.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-fail/a-decision-is-newer-than-the-brief/docs/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-fail/a-round-record-has-no-date/docs/rounds/page-size/record.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-fail/a-round-record-has-no-date/docs/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-fail/the-brief-carries-no-date/docs/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-fail/the-brief-is-only-an-example/docs/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-fail/the-template-was-never-filled-in/docs/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-pass/a-quoted-diff-is-not-an-empty-bullet/docs/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-ahead-of-the-record/docs/decisions/0001-one-page-size.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-ahead-of-the-record/docs/rounds/page-size/record.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-ahead-of-the-record/docs/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-nothing-else-recorded/docs/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-pass/no-standing-brief-here/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/standing-current/must-pass/no-standing-brief-here/docs/notes.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/a-role-in-a-subfolder/.claude/agents/team/writer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/a-role-in-a-subfolder/formwork/style.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/a-word-that-merely-contains-it/.claude/agents/writer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/a-word-that-merely-contains-it/formwork/style.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/one-runtime-was-left-behind/.claude/agents/writer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/one-runtime-was-left-behind/.gemini/agents/writer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/one-runtime-was-left-behind/formwork/style.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/the-pointer-went-missing/.claude/agents/tester.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/the-pointer-went-missing/.claude/agents/writer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-fail/the-pointer-went-missing/formwork/style.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/a-readme-among-the-roles/.claude/agents/README.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/a-readme-among-the-roles/.claude/agents/writer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/a-readme-among-the-roles/formwork/style.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.claude/agents/tester.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.claude/agents/writer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.codex/agents/writer.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.gemini/agents/writer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/formwork/style.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/no-style-page-here/.claude/agents/writer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/style-pointed/must-pass/nothing-generated-yet/formwork/style.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/a-nested-status-hides-the-real-one/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing/docs/reports/0009-a-brief-nobody-wrote.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/a-status-nobody-can-read/docs/briefs/0002-something.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/done-without-read-back/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/done-without-read-back/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/finished-and-left-no-report/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/finished-and-left-no-report/docs/reports/README.md +0 -0
- {formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report → formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-fail/one-word-read-back-by-default}/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/the-report-is-empty/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/the-report-is-empty/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/two-briefs-one-number/docs/briefs/0003-first-thing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/two-briefs-one-number/docs/briefs/0003-second-thing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/two-briefs-open/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/two-briefs-open/docs/briefs/0002-printing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-a-second-answer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/a-round-is-one-brief-like-any-other/docs/briefs/0001-storage-shape.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/a-round-is-one-brief-like-any-other/docs/reports/0001-storage-shape.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/a-round-is-one-brief-like-any-other/docs/rounds/storage-shape/predictions.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/a-round-is-one-brief-like-any-other/docs/rounds/storage-shape/round.md +0 -0
- {formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/one-open-one-done-with-read-back → formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report}/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report/docs/briefs/0002-second-page-size.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/limit-raised-to-two/.formwork.toml +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/limit-raised-to-two/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/limit-raised-to-two/docs/briefs/0002-printing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/no-briefs-folder/README.md +0 -0
- {formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine → formwork_kit-1.0.1/formwork/check/fixtures/work-paired/must-pass/one-open-one-done-with-read-back}/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/one-open-one-done-with-read-back/docs/briefs/0002-printing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/one-open-one-done-with-read-back/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine/docs/briefs/0002-printing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/first-run.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/fw +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/guard/git-boundary +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/guard/quality-gate +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/guard/test_boundary.py +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/guard/test_quality_gate.py +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/install +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/method/architect.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/method/challenger.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/method/record-keeper.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/method/researcher.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/method/reviewer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/accessibility.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/ai.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/analyst.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/backend.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/brainstormer.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/data.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/devops.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/integrations.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/legal.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/marketing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/performance.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/product.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/security.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/sre.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/tester.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/user-researcher.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/roles/packs/ux.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/rules/full.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/skills/humanizer/LICENSE +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/skills/humanizer/SKILL.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/skills/humanizer/UPSTREAM.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/skills/humanizer/local.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/style.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/sync +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/templates/decision.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/templates/predictions.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/templates/round.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/templates/standing.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/test_build.py +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/test_install.py +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/test_sync.py +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/threads.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork/troubleshooting.md +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork_cli/__init__.py +0 -0
- {formwork_kit-1.0.0 → formwork_kit-1.0.1}/formwork_cli/__main__.py +0 -0
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
What changed in each release, newest first. Before 1.0.0 the record is the
|
|
4
|
+
version commit's message in git: `git show 02bd5f0` for 0.2.0 and
|
|
5
|
+
`git show 6a923da` for 0.2.1.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Unreleased
|
|
10
|
+
|
|
11
|
+
- Measuring a guard. `formwork/measure-a-guard.md` and
|
|
12
|
+
`formwork/evals/guards/run`: the same task with the guard off, on, and a
|
|
13
|
+
placebo that refuses the same calls with one generic line; the runner
|
|
14
|
+
refuses to spend without a predictions file holding the bar and the
|
|
15
|
+
decision, counts hook calls as well as refusals, and prints cost beside
|
|
16
|
+
effect. Worked once on `protected-files` with Haiku for about $0.22: with
|
|
17
|
+
the guard off the model never edited the protected check in 16 runs, so by
|
|
18
|
+
the rule written first the trap was too weak and nothing is concluded about
|
|
19
|
+
the guard (`docs/evals/0033-guard-result.md`).
|
|
20
|
+
- Review, then refute. The review round template and `lead`: reviewers by
|
|
21
|
+
dimension in parallel, findings merged by their evidence, a verifier per
|
|
22
|
+
serious finding that answers "refuted" unless the evidence holds, and a
|
|
23
|
+
reviewer that failed makes the review incomplete, never a pass.
|
|
24
|
+
- New check `task-size`: an open brief with no `size:` line counts as a task,
|
|
25
|
+
and fails once its body passes 12 lines (a line counted once per 80
|
|
26
|
+
characters) or its report names more than 5 files changed, until it says
|
|
27
|
+
the size it has become. A one line brief still carries no extra field.
|
|
28
|
+
- Bringing in somebody else's skill. `formwork/bring-a-skill.md` makes the
|
|
29
|
+
humanizer pattern general: the skill lives in `.claude/skills/<name>/` with
|
|
30
|
+
its licence and an `UPSTREAM.md` (repository, full commit, licence, sha256
|
|
31
|
+
of each file), from `formwork/templates/upstream.md`; the human fetches, and
|
|
32
|
+
nothing updates on its own. New check `skill-provenance` fails a skill folder
|
|
33
|
+
with no record, no licence, no full commit, or a file that no longer matches
|
|
34
|
+
its sha256. A skill written in the project says `written here, no upstream`.
|
|
35
|
+
- Two lines in a builder's report: files touched outside its own, and packages
|
|
36
|
+
added with licence, what they install and where they came from. In
|
|
37
|
+
`formwork/templates/build.md` and in what `lead` asks of each piece.
|
|
38
|
+
- Localisation and right to left layout have owners: `writer` owns the words
|
|
39
|
+
in every language shipped, `visual` how the layout mirrors, `frontend` and
|
|
40
|
+
`mobile` building it (leading and trailing, never left and right).
|
|
41
|
+
- Taste packs, optional. `formwork/taste/README.md` holds the three kit
|
|
42
|
+
items that apply to every product (decoration never poses as data; copy
|
|
43
|
+
says the thing, not the feature; every rendered screen is asked "generic
|
|
44
|
+
or machine made?" and "dead?") and the pack shape: each item says what it
|
|
45
|
+
catches and how it is found, high, medium or low. First packs: `screens`
|
|
46
|
+
(general rules adapted from one project's design review), `web` and `deck`
|
|
47
|
+
from cited public sources, and a short `ios` pack from the seven Human
|
|
48
|
+
Interface Guidelines pages that were read; the rest is NOT ESTABLISHED. A
|
|
49
|
+
project names its packs in its own design file, which always wins. Search
|
|
50
|
+
patterns are hints for the reviewer. Taste is never a check. The design and
|
|
51
|
+
review round templates and `formwork/route.md` point to the packs.
|
|
52
|
+
- Optional templates and gates for big work. Six one page templates in
|
|
53
|
+
`formwork/templates/`: spec, research lane, design round, build, review
|
|
54
|
+
round, release step (the general pattern only). A phase is a label on a run
|
|
55
|
+
of ordinary briefs, using `stream:`; no fixed order. New check `gates`: a
|
|
56
|
+
brief may carry one `starts:` line, `now`, `after <stream>` or `decision
|
|
57
|
+
NNNN`, and an open brief whose gate is not met, or whose gate is in prose,
|
|
58
|
+
is refused. The two default gates for a build (no build before the spec is
|
|
59
|
+
accepted; unproven items listed and seen before the next phase) are offered
|
|
60
|
+
in the spec and build templates. `formwork/route.md` offers the matching
|
|
61
|
+
template by kind and size, never as a sequence.
|
|
62
|
+
- Specialists, cheapest first. The `lead` spawns an existing role, then a
|
|
63
|
+
relabel (an existing role with a title line and optionally a skill, its
|
|
64
|
+
owns, sections and tools still from its file), and only then a new project
|
|
65
|
+
role: drafted by the `director` in the brief, accepted by the person,
|
|
66
|
+
written to `formwork/roles/project/<name>.md` by a working session. Never a pasted
|
|
67
|
+
persona. New check `roles-named`: a round file must be `<role>.md` or
|
|
68
|
+
`<role>-<label>.md` for a real role, and a role in an open brief's team
|
|
69
|
+
table must exist. `TEMPLATE.md` says a role touching plans or order names
|
|
70
|
+
the director and lead under "Does not own".
|
|
71
|
+
- Routing one plain prompt. `formwork/route.md` is the routing table: six
|
|
72
|
+
kinds of request, each with its size test, template, team and stops.
|
|
73
|
+
Default size is a task. The `director` is the only router above a task and
|
|
74
|
+
says the plan back in one or two lines before acting. Corrections go in
|
|
75
|
+
`docs/routing.md`, in the person's words (`formwork/templates/routing.md`).
|
|
76
|
+
Routing accuracy, measured: 44 and 45 of 49 in two runs with Haiku.
|
|
77
|
+
- `formwork/evals/routing/`: 49 plain prompts with the expected kind, size
|
|
78
|
+
and first step, and `run`, which sends each to a fresh safe mode
|
|
79
|
+
`claude -p` session holding only the routing table and the director, and
|
|
80
|
+
prints the score. `--dry-run` checks the set and spends nothing.
|
|
81
|
+
- `formwork/route.md`: a new product's first brief is a one page spec, and a
|
|
82
|
+
round comes later; size the work, not the words.
|
|
83
|
+
- `formwork setup` asks a twelfth question and offers the two routing lines
|
|
84
|
+
(`formwork/templates/project-instructions.md`) as `CLAUDE.md`, `AGENTS.md`
|
|
85
|
+
or `GEMINI.md` by runtime, only when the file does not exist. When it does,
|
|
86
|
+
setup shows the lines to paste and writes nothing there.
|
|
87
|
+
- `formwork/templates/personal-defaults.md`: a page to copy into your own
|
|
88
|
+
global instruction file, with one line pointing at formwork's routing.
|
|
89
|
+
- `predictions-first` reads rounds outside `docs/rounds/`: any folder under
|
|
90
|
+
`docs/` with a predictions file (`predictions.md`, `*-predictions.md`) or a
|
|
91
|
+
challenge file (`challenge.md`, `challenger.md`). A challenge file with no
|
|
92
|
+
predictions on record fails. Predictions under a heading inside the
|
|
93
|
+
challenge file pass with a warning.
|
|
94
|
+
- `standing-current` compares the standing brief with dated briefs and
|
|
95
|
+
reports (`date:`, `updated:`, `accepted:`), and fails a "What is next" that
|
|
96
|
+
names a brief marked done or dropped.
|
|
97
|
+
- `open_briefs_per = "stream"` under `[strength]` makes `open_briefs` the
|
|
98
|
+
limit for each stream, read from a brief's `stream:` or `**Stream:**` line.
|
|
99
|
+
- `formwork/COSTS.md` counts thirteen checks, not twelve.
|
|
100
|
+
- New check `kit-leak-scan` reads kit files only (`formwork/`,
|
|
101
|
+
`formwork_cli/`, `FORMWORK.md`, generated roles) and fails on a real looking
|
|
102
|
+
home path, a private network address, a local hostname, an email address or
|
|
103
|
+
an API key shaped string. Placeholders such as `/Users/<you>/` and
|
|
104
|
+
`example.com` pass. It cannot see a machine named in plain words.
|
|
105
|
+
- `protected-files` checks Codex `apply_patch` headers, including patches fed
|
|
106
|
+
through shell arguments, wrappers, pipes, and heredocs, before a guarded
|
|
107
|
+
file can be changed. It reads Codex's whitespace forms and refuses an
|
|
108
|
+
`apply_patch` call with no readable patch text.
|
|
109
|
+
- `guard-wired` checks every runtime named in `[bindings].runtimes` and any
|
|
110
|
+
wiring file that names a formwork guard. Codex requires the two tool guards,
|
|
111
|
+
with a matcher whose regex reaches a Codex patch tool name; `Edit` and
|
|
112
|
+
`Write` are accepted as well as `apply_patch`.
|
|
113
|
+
|
|
114
|
+
## 1.0.0
|
|
115
|
+
|
|
116
|
+
**This one can turn a green gate red.** Two checks are stricter and there is a
|
|
117
|
+
new core rule. By [`RELEASING.md`](RELEASING.md) that is a breaking change, so
|
|
118
|
+
the first number moves.
|
|
119
|
+
|
|
120
|
+
### Can turn your gate red
|
|
121
|
+
|
|
122
|
+
- `work-paired` allows one open brief at a time. Raise it with `open_briefs`
|
|
123
|
+
under `[strength]`, and 0 means no limit.
|
|
124
|
+
- `work-paired` refuses a brief marked `done` until its report carries
|
|
125
|
+
`accepted:` with a date and `in my words:` with a sentence, five words by
|
|
126
|
+
default. Change it with `read_back_words` under `[strength]`: 1 lets a
|
|
127
|
+
single word through, and 0 lets the line be empty.
|
|
128
|
+
- New check, `report-shape`: a report opens with `## For you`, a part for the
|
|
129
|
+
human, under 1,000 words and with no commands, before `## For the director`.
|
|
130
|
+
Reports written before the rule pass if they carry a dated `## For you`
|
|
131
|
+
bridge above their old headings.
|
|
132
|
+
|
|
133
|
+
### Added
|
|
134
|
+
|
|
135
|
+
- `formwork sync`. After upgrading the command, run it inside a project and
|
|
136
|
+
the project's `formwork/` and `FORMWORK.md` come up to the installed
|
|
137
|
+
release. Files the project owns stay: its own roles in the project pack, and
|
|
138
|
+
anything listed as `local` under `[bindings]` in `.formwork.toml`. It writes
|
|
139
|
+
the release into the project's SOURCE.txt and stops before recording the
|
|
140
|
+
fingerprints, because that is yours to do. `formwork/fw sync <project>` does
|
|
141
|
+
the same from a clean clone of the kit, pinned to the commit.
|
|
142
|
+
- `formwork/skills/`, and the first skill in it, `humanizer` 3.1.0, pinned to
|
|
143
|
+
one upstream commit with formwork's change to its rule on bold kept in a
|
|
144
|
+
separate file. `formwork roles` places it in `.claude/skills/` on Claude
|
|
145
|
+
Code, and `generated-current` goes red if that copy is edited by hand.
|
|
146
|
+
- `formwork/style.md`: text the agent writes as you, such as an email or a
|
|
147
|
+
comment, goes through `humanizer` first. A section on reports for two
|
|
148
|
+
readers.
|
|
149
|
+
- A fourteenth core rule: the human is not the courier.
|
|
150
|
+
- A role's `description`, `model`, `skills` and `color` reach the generated
|
|
151
|
+
Claude Code agent instead of being dropped. Codex and Gemini CLI get the
|
|
152
|
+
description and a note.
|
|
153
|
+
|
|
154
|
+
### Counts
|
|
155
|
+
|
|
156
|
+
Three guards, thirteen checks, twenty eight roles, forty eight rules, one
|
|
157
|
+
skill, 494 tests.
|
|
@@ -20,6 +20,10 @@ sizes, and how to pick one, are in [`formwork/loop.md`](formwork/loop.md).
|
|
|
20
20
|
Work is handed down from a planning conversation and reported back up by you.
|
|
21
21
|
That part is in [`formwork/threads.md`](formwork/threads.md).
|
|
22
22
|
|
|
23
|
+
**One plain prompt is enough to start.** What kind of work it is, how big, and
|
|
24
|
+
who does it are worked out from [`formwork/route.md`](formwork/route.md), and
|
|
25
|
+
said back to you in a line or two before anything happens.
|
|
26
|
+
|
|
23
27
|
---
|
|
24
28
|
|
|
25
29
|
## What is blocked
|
|
@@ -40,7 +44,13 @@ These do not ask you. They refuse.
|
|
|
40
44
|
| Work marked finished left a report behind | `formwork/check/checks/work-paired` |
|
|
41
45
|
| Work marked finished carries the human's read-back, dated | `formwork/check/checks/work-paired` |
|
|
42
46
|
| One brief is open at a time, unless you raise the limit | `formwork/check/checks/work-paired` |
|
|
47
|
+
| An open task that grew past a task says its size | `formwork/check/checks/task-size` |
|
|
48
|
+
| An open brief with a `starts:` gate does not run before the gate is met | `formwork/check/checks/gates` |
|
|
43
49
|
| Every generated role names the style page | `formwork/check/checks/style-pointed` |
|
|
50
|
+
| Kit files carry no home path, private address, local hostname, email or key | `formwork/check/checks/kit-leak-scan` |
|
|
51
|
+
| Kit files carry no character a reader cannot see | `formwork/check/checks/hidden-unicode` |
|
|
52
|
+
| A skill brought in from elsewhere names its commit, keeps its licence, and still matches | `formwork/check/checks/skill-provenance` |
|
|
53
|
+
| A round file or a brief's team row names a real role | `formwork/check/checks/roles-named` |
|
|
44
54
|
| A report opens with a part for the human, under 1,000 words, no commands | `formwork/check/checks/report-shape` |
|
|
45
55
|
|
|
46
56
|
> [!NOTE]
|
|
@@ -125,12 +135,14 @@ protect_files = "block" # block | warn | off
|
|
|
125
135
|
aggregate_gate = "block" # the turn-end gate
|
|
126
136
|
gate_budget = 3 # refusals before it stands aside
|
|
127
137
|
open_briefs = 1 # briefs open at once, 0 for no limit
|
|
138
|
+
open_briefs_per = "project" # project | stream: the limit for each stream
|
|
139
|
+
read_back_words = 5 # words after "in my words:", 0 for none
|
|
128
140
|
```
|
|
129
141
|
|
|
130
142
|
`[bindings]` is your setup. `[strength]` tunes how hard the enforced guards
|
|
131
143
|
bite. There is no third section: see above.
|
|
132
144
|
|
|
133
|
-
**The last
|
|
145
|
+
**The last five lines appear only once you change them.** They have working
|
|
134
146
|
defaults, so a fresh file is shorter than this.
|
|
135
147
|
|
|
136
148
|
**You do not have to write any of it by hand.** `formwork setup` asks a few
|
|
@@ -141,6 +153,7 @@ you say yes:
|
|
|
141
153
|
- `docs/standing.md`, seeded with what you are building and what is next
|
|
142
154
|
- `docs/decisions/`, `docs/briefs/`, `docs/reports/`, started and explained
|
|
143
155
|
- the `[strength]` values, including `gate_budget`
|
|
156
|
+
- the two routing lines in `CLAUDE.md` or `AGENTS.md`, only when there is none
|
|
144
157
|
|
|
145
158
|
It never overwrites a file you already have, and it never touches
|
|
146
159
|
`[bindings]`, which the installer worked out by looking at your project.
|
|
@@ -166,6 +179,18 @@ rather than describing one that does not exist.
|
|
|
166
179
|
Adding your own is copying `TEMPLATE.md`, filling in five sections and four
|
|
167
180
|
frontmatter fields. A role missing any of them does not load.
|
|
168
181
|
|
|
182
|
+
**Specialists, cheapest first.** The lead spawns an existing role. If the work
|
|
183
|
+
needs a focus, it relabels one: "`visual` as art director", optionally with a
|
|
184
|
+
skill, with its owns, sections and tools still from its own file. Only when no
|
|
185
|
+
existing `owns` covers the work is a new role written: the director drafts it
|
|
186
|
+
in the brief in the five section format, your go accepts it, a working session
|
|
187
|
+
writes it to `formwork/roles/project/<name>.md` and runs `formwork roles` and
|
|
188
|
+
`formwork check`, and then the lead may spawn it. Never a pasted persona or a
|
|
189
|
+
general agent given a role's text in a prompt: nothing checks its boundary or
|
|
190
|
+
tools. `roles-named` fails a round file or a brief's team row that names no
|
|
191
|
+
real role. Whether a role written mid session can be spawned in the same
|
|
192
|
+
session is NOT ESTABLISHED, so adding one is its own task brief.
|
|
193
|
+
|
|
169
194
|
**How they talk to you** is one page, [`formwork/style.md`](formwork/style.md),
|
|
170
195
|
pointed at from every generated role. Your own `docs/style.md` overrides it.
|
|
171
196
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: formwork-kit
|
|
3
|
-
Version: 1.0.
|
|
3
|
+
Version: 1.0.1
|
|
4
4
|
Summary: You bring the idea. It brings the whole team. Rules your coding agent cannot ignore.
|
|
5
5
|
Project-URL: Homepage, https://github.com/makariim/formwork
|
|
6
6
|
Project-URL: Source, https://github.com/makariim/formwork
|
|
@@ -59,7 +59,7 @@ own. Projects never had that. Now they do.*
|
|
|
59
59
|
$ pipx install formwork-kit
|
|
60
60
|
$ formwork init && formwork install
|
|
61
61
|
$ formwork setup && formwork check
|
|
62
|
-
GATE: green.
|
|
62
|
+
GATE: green. 14 check(s), each shown to reject the wrong and accept the right.
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
<div align="center">
|
|
@@ -277,8 +277,8 @@ the list. `where` and `version` belong to the installed command only.
|
|
|
277
277
|
|---|---|
|
|
278
278
|
| `init` | puts `formwork/` and `FORMWORK.md` into your project |
|
|
279
279
|
| `install` | wires the guards into your agent, writes your role files. Add `--runtime <name>` when it cannot tell |
|
|
280
|
-
| `setup` | asks
|
|
281
|
-
| `check` | runs all
|
|
280
|
+
| `setup` | asks twelve questions once, then writes your style file, your standing brief, the folders for decisions, briefs and reports, and the two routing lines when your project has no instruction file |
|
|
281
|
+
| `check` | runs all nineteen checks and says green or red |
|
|
282
282
|
| `sync` | later, after you upgrade the command: brings the project's `formwork/` up to the new release, keeps the files the project owns, and says what it changed |
|
|
283
283
|
|
|
284
284
|
**What it touches.** It adds `formwork/` and `FORMWORK.md`, writes
|
|
@@ -384,11 +384,11 @@ in your own words, which beats it. Every role points at both.
|
|
|
384
384
|
| | | count it yourself |
|
|
385
385
|
|---|---|---|
|
|
386
386
|
| **3 guards** | small programs that refuse. Two stop a command, one stops a turn ending | `ls formwork/guard \| grep -v test_` |
|
|
387
|
-
| **
|
|
387
|
+
| **19 checks** | small programs that read your project and say green or red | `ls formwork/check/checks \| wc -l` |
|
|
388
388
|
| **28 roles** | one file each, saying what that job does and where it stops | `ls formwork/roles/*/*.md \| wc -l` |
|
|
389
389
|
| **48 rules** | 14 you meet daily, 34 for when you need them | `grep -c '^### ' formwork/rules/*.md` |
|
|
390
390
|
| **1 skill** | `humanizer`, pinned at one upstream commit, for text the agent writes as you | `ls formwork/skills` |
|
|
391
|
-
| **
|
|
391
|
+
| **571 tests** | every guard and check, proved able to fail | `formwork test` |
|
|
392
392
|
|
|
393
393
|
It is all text files and small programs. You can read every line. Nothing is
|
|
394
394
|
hidden. Nothing is sent anywhere.
|
|
@@ -468,8 +468,10 @@ better after you have run it once than before.
|
|
|
468
468
|
| [`threads.md`](formwork/threads.md) | how work starts, and where the plan lives between conversations |
|
|
469
469
|
| [`style.md`](formwork/style.md) | how the agents talk to you, and how to change it |
|
|
470
470
|
| [`round.md`](formwork/round.md) | how to run a round, and when it is worth it |
|
|
471
|
-
| [`templates/`](formwork/templates/) | brief, predictions, report, decision, round, standing brief |
|
|
471
|
+
| [`templates/`](formwork/templates/) | brief, predictions, report, decision, round, standing brief; optional ones for a phase: spec, research lane, design round, build, review round, release step; and the upstream record for a skill brought in |
|
|
472
|
+
| [`taste/`](formwork/taste/) | optional taste packs: three kit items for every product, and packs for screens, web, deck and iOS, each item saying what it catches and how it is found. Never a check |
|
|
472
473
|
| [`skills/`](formwork/skills/) | skills the kit ships, each pinned to an upstream commit |
|
|
474
|
+
| [`bring-a-skill.md`](formwork/bring-a-skill.md) | how a project brings in somebody else's skill: pinned commit, licence kept, sha256, nothing updates on its own |
|
|
473
475
|
| [`roles/`](formwork/roles/) | the roles, and how to write your own |
|
|
474
476
|
| [`rules/`](formwork/rules/) | the rules, each saying what it catches |
|
|
475
477
|
|
|
@@ -480,6 +482,7 @@ better after you have run it once than before.
|
|
|
480
482
|
| [`troubleshooting.md`](formwork/troubleshooting.md) | every error message and what to do |
|
|
481
483
|
| [`glossary.md`](formwork/glossary.md) | every word we use, in plain language |
|
|
482
484
|
| [`limits.md`](formwork/limits.md) | what this kit cannot do |
|
|
485
|
+
| [`measure-a-guard.md`](formwork/measure-a-guard.md) | how to measure what a guard changes: off, on and a placebo, the bar written first, cost beside effect |
|
|
483
486
|
| [`COSTS.md`](formwork/COSTS.md) | what it costs, and the number nobody has |
|
|
484
487
|
| [`FAQ.md`](FAQ.md) | questions people ask |
|
|
485
488
|
|
|
@@ -30,7 +30,7 @@ own. Projects never had that. Now they do.*
|
|
|
30
30
|
$ pipx install formwork-kit
|
|
31
31
|
$ formwork init && formwork install
|
|
32
32
|
$ formwork setup && formwork check
|
|
33
|
-
GATE: green.
|
|
33
|
+
GATE: green. 14 check(s), each shown to reject the wrong and accept the right.
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
<div align="center">
|
|
@@ -248,8 +248,8 @@ the list. `where` and `version` belong to the installed command only.
|
|
|
248
248
|
|---|---|
|
|
249
249
|
| `init` | puts `formwork/` and `FORMWORK.md` into your project |
|
|
250
250
|
| `install` | wires the guards into your agent, writes your role files. Add `--runtime <name>` when it cannot tell |
|
|
251
|
-
| `setup` | asks
|
|
252
|
-
| `check` | runs all
|
|
251
|
+
| `setup` | asks twelve questions once, then writes your style file, your standing brief, the folders for decisions, briefs and reports, and the two routing lines when your project has no instruction file |
|
|
252
|
+
| `check` | runs all nineteen checks and says green or red |
|
|
253
253
|
| `sync` | later, after you upgrade the command: brings the project's `formwork/` up to the new release, keeps the files the project owns, and says what it changed |
|
|
254
254
|
|
|
255
255
|
**What it touches.** It adds `formwork/` and `FORMWORK.md`, writes
|
|
@@ -355,11 +355,11 @@ in your own words, which beats it. Every role points at both.
|
|
|
355
355
|
| | | count it yourself |
|
|
356
356
|
|---|---|---|
|
|
357
357
|
| **3 guards** | small programs that refuse. Two stop a command, one stops a turn ending | `ls formwork/guard \| grep -v test_` |
|
|
358
|
-
| **
|
|
358
|
+
| **19 checks** | small programs that read your project and say green or red | `ls formwork/check/checks \| wc -l` |
|
|
359
359
|
| **28 roles** | one file each, saying what that job does and where it stops | `ls formwork/roles/*/*.md \| wc -l` |
|
|
360
360
|
| **48 rules** | 14 you meet daily, 34 for when you need them | `grep -c '^### ' formwork/rules/*.md` |
|
|
361
361
|
| **1 skill** | `humanizer`, pinned at one upstream commit, for text the agent writes as you | `ls formwork/skills` |
|
|
362
|
-
| **
|
|
362
|
+
| **571 tests** | every guard and check, proved able to fail | `formwork test` |
|
|
363
363
|
|
|
364
364
|
It is all text files and small programs. You can read every line. Nothing is
|
|
365
365
|
hidden. Nothing is sent anywhere.
|
|
@@ -439,8 +439,10 @@ better after you have run it once than before.
|
|
|
439
439
|
| [`threads.md`](formwork/threads.md) | how work starts, and where the plan lives between conversations |
|
|
440
440
|
| [`style.md`](formwork/style.md) | how the agents talk to you, and how to change it |
|
|
441
441
|
| [`round.md`](formwork/round.md) | how to run a round, and when it is worth it |
|
|
442
|
-
| [`templates/`](formwork/templates/) | brief, predictions, report, decision, round, standing brief |
|
|
442
|
+
| [`templates/`](formwork/templates/) | brief, predictions, report, decision, round, standing brief; optional ones for a phase: spec, research lane, design round, build, review round, release step; and the upstream record for a skill brought in |
|
|
443
|
+
| [`taste/`](formwork/taste/) | optional taste packs: three kit items for every product, and packs for screens, web, deck and iOS, each item saying what it catches and how it is found. Never a check |
|
|
443
444
|
| [`skills/`](formwork/skills/) | skills the kit ships, each pinned to an upstream commit |
|
|
445
|
+
| [`bring-a-skill.md`](formwork/bring-a-skill.md) | how a project brings in somebody else's skill: pinned commit, licence kept, sha256, nothing updates on its own |
|
|
444
446
|
| [`roles/`](formwork/roles/) | the roles, and how to write your own |
|
|
445
447
|
| [`rules/`](formwork/rules/) | the rules, each saying what it catches |
|
|
446
448
|
|
|
@@ -451,6 +453,7 @@ better after you have run it once than before.
|
|
|
451
453
|
| [`troubleshooting.md`](formwork/troubleshooting.md) | every error message and what to do |
|
|
452
454
|
| [`glossary.md`](formwork/glossary.md) | every word we use, in plain language |
|
|
453
455
|
| [`limits.md`](formwork/limits.md) | what this kit cannot do |
|
|
456
|
+
| [`measure-a-guard.md`](formwork/measure-a-guard.md) | how to measure what a guard changes: off, on and a placebo, the bar written first, cost beside effect |
|
|
454
457
|
| [`COSTS.md`](formwork/COSTS.md) | what it costs, and the number nobody has |
|
|
455
458
|
| [`FAQ.md`](FAQ.md) | questions people ask |
|
|
456
459
|
|
|
@@ -7,15 +7,16 @@ Two of the three numbers below are measured. The most important one is not.
|
|
|
7
7
|
## The gate. Measured
|
|
8
8
|
|
|
9
9
|
```
|
|
10
|
-
$ time formwork check
|
|
11
|
-
real
|
|
12
|
-
real
|
|
13
|
-
real
|
|
10
|
+
$ /usr/bin/time -p formwork/fw check
|
|
11
|
+
real 17.57
|
|
12
|
+
real 7.08
|
|
13
|
+
real 13.62
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
16
|
+
Between seven and eighteen seconds on this repository, over three runs on
|
|
17
|
+
2026-11-15, on a machine doing other work. The spread is the machine, not the
|
|
18
|
+
gate. That is one run of all seventeen checks over 409 files, including the
|
|
19
|
+
fixtures each check is tried against. It runs at the end of
|
|
19
20
|
every turn in which something changed.
|
|
20
21
|
|
|
21
22
|
**What would make that wrong:** it scales with how many files you have, and with
|
|
@@ -25,11 +26,11 @@ this line.
|
|
|
25
26
|
## What the kit adds to your repository. Measured
|
|
26
27
|
|
|
27
28
|
```
|
|
28
|
-
$ find formwork -type f | wc -l
|
|
29
|
-
|
|
29
|
+
$ find formwork -type f -not -path '*/__pycache__/*' | wc -l
|
|
30
|
+
454
|
|
30
31
|
```
|
|
31
32
|
|
|
32
|
-
|
|
33
|
+
454 files, counted with the `task-size` check and its fixtures in place. Plain text and a few small programs. Python 3, standard library only,
|
|
33
34
|
no dependencies of any kind. It costs nothing to carry and nothing to install.
|
|
34
35
|
|
|
35
36
|
---
|
|
@@ -1,21 +1,32 @@
|
|
|
1
1
|
# Codex adapter
|
|
2
2
|
|
|
3
|
-
**Label: untested.** The
|
|
4
|
-
it. It stays untested until somebody watches it work.
|
|
3
|
+
**Label: untested.** The hook wiring has not been watched in a live Codex task.
|
|
5
4
|
|
|
6
5
|
## Blocking
|
|
7
6
|
|
|
8
|
-
Codex refuses a tool call on exit code 2
|
|
9
|
-
|
|
7
|
+
Codex refuses a tool call on exit code 2. Wire both guards to `PreToolUse`
|
|
8
|
+
with a matcher that includes `Bash|apply_patch`, pointing at:
|
|
10
9
|
|
|
11
10
|
```
|
|
12
11
|
formwork/guard/git-boundary --format codex
|
|
13
12
|
formwork/guard/protected-files --format codex
|
|
14
13
|
```
|
|
15
14
|
|
|
16
|
-
Hooks go in `.codex/hooks.json
|
|
17
|
-
|
|
18
|
-
|
|
15
|
+
Hooks go in `.codex/hooks.json`. `protected-files` reads the paths in Codex
|
|
16
|
+
`apply_patch` headers, including padded headers and patches passed through
|
|
17
|
+
shell arguments, wrappers, pipes, and heredocs. It checks `Add File`,
|
|
18
|
+
`Update File`, `Delete File`, and `Move to` paths. An `apply_patch` or
|
|
19
|
+
`applypatch` call with no readable patch text is refused. `guard-wired` also
|
|
20
|
+
accepts a Codex matcher such as `Bash|Edit|Write`: Codex's `Edit` and `Write`
|
|
21
|
+
names cover patch calls, while `Bash` covers shell calls.
|
|
22
|
+
|
|
23
|
+
For a project that also uses another runtime, list them under `[bindings]`:
|
|
24
|
+
|
|
25
|
+
runtime = "claude-code"
|
|
26
|
+
runtimes = ["claude-code", "codex"]
|
|
27
|
+
|
|
28
|
+
`guard-wired` checks both runtimes. Codex has no supported `Stop` hook for
|
|
29
|
+
`quality-gate`, so run `formwork/check/run` by hand at the end of a Codex task.
|
|
19
30
|
|
|
20
31
|
## Roles
|
|
21
32
|
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# Bringing in somebody else's skill
|
|
2
|
+
|
|
3
|
+
A skill is a file of instructions that runs inside your agents. A skill
|
|
4
|
+
written by somebody else is their instructions, running in your project. Bring
|
|
5
|
+
one in the way the kit brought in its own one, `humanizer`
|
|
6
|
+
([`skills/humanizer/UPSTREAM.md`](skills/humanizer/UPSTREAM.md)): from one
|
|
7
|
+
commit you can name, with its licence beside it, and with a record that says
|
|
8
|
+
exactly which bytes you took.
|
|
9
|
+
|
|
10
|
+
The kit ships no catalogue of skills, and never fetches one. You fetch. The
|
|
11
|
+
kit only says how to keep what you fetched.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Before you bring one in
|
|
16
|
+
|
|
17
|
+
1. **Look for an existing role first.** Most stack and craft knowledge already
|
|
18
|
+
has an owner in `formwork/roles/`. A skill adds depth to a role; it does not
|
|
19
|
+
replace one.
|
|
20
|
+
2. **Find the licence.** A file with no licence is not free to use, the rule
|
|
21
|
+
in `formwork/roles/packs/legal.md`. No licence file in the source
|
|
22
|
+
repository means you do not bring it in. Ask the author, or write your own.
|
|
23
|
+
3. **Read all of it.** It will run in every agent that loads it, with that
|
|
24
|
+
agent's tools.
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## Where it lives in a project
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
.claude/skills/<name>/
|
|
32
|
+
SKILL.md copied byte for byte from the source
|
|
33
|
+
LICENSE the source's licence file, copied byte for byte
|
|
34
|
+
UPSTREAM.md where both came from, from formwork/templates/upstream.md
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
- **Not under `formwork/`.** `formwork sync` replaces that folder with the
|
|
38
|
+
kit's own copy, and a skill there would be deleted on the next sync.
|
|
39
|
+
- **`.claude/skills/`** is where Claude Code finds a project's skills. The kit
|
|
40
|
+
does not know where Codex, Gemini CLI or Cursor read skills from (NOT
|
|
41
|
+
ESTABLISHED), so on those the role that uses it reads the file by its path.
|
|
42
|
+
- **The name must not be one the kit ships.** `formwork roles` will not
|
|
43
|
+
overwrite a file it did not make, so a clash leaves yours in place and says
|
|
44
|
+
so, but the kit's skill is then missing.
|
|
45
|
+
- **Never edit `SKILL.md` or `LICENSE`.** Your own change goes in the project
|
|
46
|
+
role that uses the skill, under a heading such as "Where this project differs
|
|
47
|
+
from the skill". Then an update stays a straight copy.
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Who uses it
|
|
52
|
+
|
|
53
|
+
A role names it, in the project's own role for that work
|
|
54
|
+
(`formwork/roles/HOW-TO-ADD-A-ROLE.md` says how to write one):
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
skills:
|
|
58
|
+
- <name>
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
On Claude Code that binds the skill to the role when `formwork roles` runs.
|
|
62
|
+
Elsewhere the generated file notes it, so say in the role's body: "read
|
|
63
|
+
`.claude/skills/<name>/SKILL.md` before you start". A skill no role names is a
|
|
64
|
+
file nobody reads; naming it only in a brief works for that one brief.
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## The record
|
|
69
|
+
|
|
70
|
+
Copy [`templates/upstream.md`](templates/upstream.md) to
|
|
71
|
+
`.claude/skills/<name>/UPSTREAM.md` and fill in every line:
|
|
72
|
+
|
|
73
|
+
| line | where it comes from |
|
|
74
|
+
|---|---|
|
|
75
|
+
| repository | the source's address |
|
|
76
|
+
| commit | the full commit you copied from, never a branch name |
|
|
77
|
+
| version and date | the source's own version, if it has one, and the commit date |
|
|
78
|
+
| licence | its name and copyright line, as the LICENSE file says |
|
|
79
|
+
| sha256 | one line per file, from `shasum -a 256 SKILL.md LICENSE` |
|
|
80
|
+
|
|
81
|
+
A record that names a branch, or has no sha256, cannot tell you later whether
|
|
82
|
+
the file in front of you is the file you read.
|
|
83
|
+
|
|
84
|
+
**A skill written in this project needs no record.** Put one line in its
|
|
85
|
+
folder's `UPSTREAM.md` instead: `written here, no upstream`.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Nothing updates on its own
|
|
90
|
+
|
|
91
|
+
A new upstream version takes effect only when somebody chooses it. To update:
|
|
92
|
+
|
|
93
|
+
1. Read the upstream diff from the recorded commit to the new one, all of it.
|
|
94
|
+
2. Fetch `SKILL.md` and `LICENSE` at the new commit, and nothing else.
|
|
95
|
+
3. Check that the project role's own change still fits.
|
|
96
|
+
4. Change the commit, version, date and sha256 lines.
|
|
97
|
+
5. Run `formwork roles`, then `formwork check`.
|
|
98
|
+
6. Commit it, so the update is one change in version control with your name on
|
|
99
|
+
it.
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## What this does not do
|
|
104
|
+
|
|
105
|
+
- **It does not judge the skill.** Whether it is any good is the role's call,
|
|
106
|
+
and the reviewer's.
|
|
107
|
+
- **It does not check the licence lets you do what you do with it.** That is
|
|
108
|
+
`legal`.
|
|
109
|
+
- **It does not stop somebody editing the copied file.** The check
|
|
110
|
+
`skill-provenance` notices at the next `formwork check`: it fails a skill
|
|
111
|
+
folder with no record, no licence, no full commit, or a file whose sha256 no
|
|
112
|
+
longer matches. It fetches nothing, so it cannot tell whether the commit is
|
|
113
|
+
real.
|
|
@@ -36,7 +36,7 @@ OURS = ("formwork/",)
|
|
|
36
36
|
# Third-party and generated trees. Without these, a single install of
|
|
37
37
|
# somebody's dependencies produced dozens of findings about other people's
|
|
38
38
|
# READMEs, and the file count in the summary was meaningless.
|
|
39
|
-
SKIP_DIRS = {".git", "node_modules", "__pycache__", ".venv", "venv", "env",
|
|
39
|
+
SKIP_DIRS = {".git", ".build", "node_modules", "__pycache__", ".venv", "venv", "env",
|
|
40
40
|
".tox", ".nox", "build", "dist", "target", "vendor",
|
|
41
41
|
"site-packages", ".next", ".nuxt", "coverage", ".mypy_cache",
|
|
42
42
|
".pytest_cache", ".ruff_cache", ".gradle", "Pods"}
|