formwork-kit 0.2.1__tar.gz → 1.0.0__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.0/CHANGELOG.md +50 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/FORMWORK.md +27 -3
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/PKG-INFO +13 -9
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/README.md +12 -8
- formwork_kit-1.0.0/formwork/build +622 -0
- formwork_kit-1.0.0/formwork/check/checks/report-shape +200 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/role-shape +6 -1
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/work-paired +98 -4
- formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.claude/agents/sample.md +27 -0
- formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.codex/agents/sample.toml +26 -0
- formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.gemini/agents/sample.md +27 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand}/formwork/build +117 -6
- formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/formwork/roles/method/sample.md +24 -0
- formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.claude/agents/sample.md +27 -0
- formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.codex/agents/sample.toml +26 -0
- formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.gemini/agents/sample.md +27 -0
- formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/formwork/build +530 -0
- formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/formwork/roles/method/sample.md +24 -0
- formwork_kit-1.0.0/formwork/check/fixtures/guard-wired/must-fail/file-but-not-wired/.formwork.toml +1 -0
- formwork_kit-1.0.0/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired/.formwork.toml +1 -0
- formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-fail/a-command-in-the-human-part/docs/reports/0001-slow-login.md +54 -0
- formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-fail/no-part-for-the-human/docs/reports/0001-slow-login.md +30 -0
- formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-fail/over-the-ceiling/docs/reports/0001-slow-login.md +61 -0
- formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-fail/the-director-comes-first/docs/reports/0001-slow-login.md +49 -0
- formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-pass/a-bridge-written-before-the-rule/docs/reports/0001-slow-login.md +40 -0
- formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-pass/no-reports-folder/README.md +1 -0
- formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-pass/the-task-version/docs/reports/0002-rename-foo.md +13 -0
- formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-pass/two-parts-in-order/docs/reports/0001-slow-login.md +48 -0
- {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing}/docs/reports/0001-slow-login.md +3 -0
- {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/done-without-read-back}/docs/reports/0001-slow-login.md +2 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/two-briefs-open/docs/briefs/0001-slow-login.md +18 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-a-second-answer.md +6 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-slow-login.md +6 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/a-round-is-one-brief-like-any-other/docs/reports/0001-storage-shape.md +3 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report/docs/reports/0001-slow-login.md +3 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/limit-raised-to-two/.formwork.toml +5 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/limit-raised-to-two/docs/briefs/0001-slow-login.md +18 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/limit-raised-to-two/docs/briefs/0002-printing.md +18 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/one-open-one-done-with-read-back/docs/briefs/0001-slow-login.md +18 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/one-open-one-done-with-read-back/docs/briefs/0002-printing.md +18 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/one-open-one-done-with-read-back/docs/reports/0001-slow-login.md +18 -0
- formwork_kit-1.0.0/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/check/fixtures/work-paired/must-pass/work-still-open-is-fine/docs/briefs/0002-printing.md +18 -0
- formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine/docs/reports/0001-slow-login.md +18 -0
- formwork_kit-1.0.0/formwork/check/test_gate.py +407 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/first-run.md +12 -1
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/fw +8 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/glossary.md +1 -1
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/install +3 -2
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/limits.md +25 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/loop.md +4 -2
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/HOW-TO-ADD-A-ROLE.md +7 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/TEMPLATE.md +15 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/director.md +45 -2
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/lead.md +5 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/rules/core.md +21 -1
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/rules/full.md +1 -1
- formwork_kit-1.0.0/formwork/skills/humanizer/LICENSE +21 -0
- formwork_kit-1.0.0/formwork/skills/humanizer/SKILL.md +397 -0
- formwork_kit-1.0.0/formwork/skills/humanizer/UPSTREAM.md +29 -0
- formwork_kit-1.0.0/formwork/skills/humanizer/local.md +11 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/style.md +34 -0
- formwork_kit-1.0.0/formwork/sync +315 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/templates/brief.md +3 -0
- formwork_kit-1.0.0/formwork/templates/report.md +127 -0
- formwork_kit-1.0.0/formwork/test_build.py +257 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/test_install.py +8 -2
- formwork_kit-1.0.0/formwork/test_sync.py +274 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/threads.md +17 -7
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork_cli/__init__.py +38 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/pyproject.toml +2 -2
- formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-a-second-answer.md +0 -3
- formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-slow-login.md +0 -3
- formwork_kit-0.2.1/formwork/check/test_gate.py +0 -222
- formwork_kit-0.2.1/formwork/templates/report.md +0 -58
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/.gitignore +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/LICENSE +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/COSTS.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/claude-code/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/claude-code/settings.json +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/codex/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/cursor/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/gemini-cli/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/config-shape +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/decision-ids +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/doc-links +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/generated-current +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/guard-wired +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/kit-integrity +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/predictions-first +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/rule-labels +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/standing-current +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/style-pointed +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-fail/documents-a-section-that-does-not-exist/.formwork.toml +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-fail/documents-a-section-that-does-not-exist/formwork/guide.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-fail/rules-as-a-switchboard/.formwork.toml +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-pass/layers-kept-apart/.formwork.toml +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-fail/a-placeholder-shipped/docs/decisions/0003-still-pending.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-fail/superseded-by-nothing/docs/decisions/0002-old.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-fail/two-decisions-one-number/docs/decisions/0007-first.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-fail/two-decisions-one-number/docs/decisions/0007-second.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-pass/clean-numbering/docs/decisions/0001-the-first.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-pass/clean-numbering/docs/decisions/0002-the-second.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-pass/clean-numbering/docs/decisions/0003-the-third.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-pass/nothing-recorded-yet/docs/decisions/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/never-written/index.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/renamed-file/architecture-notes.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/renamed-file/guide.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-pass/links-resolve/architecture-notes.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-pass/links-resolve/guide.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.claude/agents/sample.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.codex/agents/sample.toml +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.formwork.toml +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.gemini/agents/sample.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/formwork/build +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/formwork/roles/method/sample.md +0 -0
- {formwork_kit-0.2.1/formwork/check/fixtures/generated-current/must-pass/generated-and-current → formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand}/.formwork.toml +0 -0
- {formwork_kit-0.2.1/formwork/check/fixtures/guard-wired/must-fail/declared-but-no-file → formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color}/.formwork.toml +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.claude/agents/sample.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.codex/agents/sample.toml +0 -0
- {formwork_kit-0.2.1/formwork/check/fixtures/guard-wired/must-fail/file-but-not-wired → formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/generated-and-current}/.formwork.toml +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.gemini/agents/sample.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/formwork/build +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/formwork/roles/method/sample.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/nothing-is-generated-here/README.md +0 -0
- {formwork_kit-0.2.1/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired → formwork_kit-1.0.0/formwork/check/fixtures/guard-wired/must-fail/declared-but-no-file}/.formwork.toml +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/guard-wired/must-fail/file-but-not-wired/.claude/settings.json +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired/.claude/settings.json +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/guard-wired/must-pass/nothing-declared/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-fail/a-check-went-missing/formwork/check/checks/still-here +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-fail/a-check-went-missing/state/fingerprints.txt +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-fail/a-guard-was-altered/formwork/guard/git-boundary +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-fail/a-guard-was-altered/state/fingerprints.txt +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-pass/everything-matches/formwork/guard/git-boundary +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-pass/everything-matches/state/fingerprints.txt +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-fail/argued-with-no-predictions/docs/rounds/0004-the-storage-question/architect.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-fail/argued-with-no-predictions/docs/rounds/0004-the-storage-question/researcher.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-fail/argued-with-no-predictions/docs/rounds/0004-the-storage-question/round.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/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-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-pass/no-rounds-at-all/docs/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-pass/predictions-on-record/docs/rounds/0005-the-shape-of-a-brief/architect.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-pass/predictions-on-record/docs/rounds/0005-the-shape-of-a-brief/predictions.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-pass/predictions-on-record/docs/rounds/0005-the-shape-of-a-brief/researcher.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/claims-a-grant-binds-everywhere/formwork/roles/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/claims-a-grant-binds-everywhere/formwork/roles/complete.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/missing-a-section/formwork/roles/vague.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/spawn-without-being-lead/formwork/roles/eager.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/two-roles-one-job/formwork/roles/first.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/two-roles-one-job/formwork/roles/second.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-pass/well-formed/formwork/roles/complete.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-fail/claims-enforcement-that-does-not-exist/formwork/rules/core.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-fail/no-catches/formwork/rules/core.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-fail/unlabelled/formwork/rules/core.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-pass/well-formed/formwork/rules/core.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/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-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-decision-hides-in-a-subfolder/docs/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/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-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-decision-is-newer-than-the-brief/docs/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-round-record-has-no-date/docs/rounds/page-size/record.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-round-record-has-no-date/docs/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/the-brief-carries-no-date/docs/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/the-brief-is-only-an-example/docs/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/the-template-was-never-filled-in/docs/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/a-quoted-diff-is-not-an-empty-bullet/docs/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/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-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-ahead-of-the-record/docs/rounds/page-size/record.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-ahead-of-the-record/docs/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-nothing-else-recorded/docs/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/no-standing-brief-here/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/no-standing-brief-here/docs/notes.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/a-role-in-a-subfolder/.claude/agents/team/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/a-role-in-a-subfolder/formwork/style.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/a-word-that-merely-contains-it/.claude/agents/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/a-word-that-merely-contains-it/formwork/style.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/one-runtime-was-left-behind/.claude/agents/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/one-runtime-was-left-behind/.gemini/agents/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/one-runtime-was-left-behind/formwork/style.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/the-pointer-went-missing/.claude/agents/tester.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/the-pointer-went-missing/.claude/agents/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/the-pointer-went-missing/formwork/style.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/a-readme-among-the-roles/.claude/agents/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/a-readme-among-the-roles/.claude/agents/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/a-readme-among-the-roles/formwork/style.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.claude/agents/tester.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.claude/agents/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.codex/agents/writer.toml +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.gemini/agents/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/formwork/style.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/no-style-page-here/.claude/agents/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/nothing-generated-yet/formwork/style.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/a-nested-status-hides-the-real-one/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing/docs/reports/0009-a-brief-nobody-wrote.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/a-status-nobody-can-read/docs/briefs/0002-something.md +0 -0
- {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-fail/finished-and-left-no-report → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/done-without-read-back}/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/finished-and-left-no-report}/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/finished-and-left-no-report/docs/reports/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/the-report-is-empty/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/the-report-is-empty/docs/reports/0001-slow-login.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/two-briefs-one-number/docs/briefs/0003-first-thing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/two-briefs-one-number/docs/briefs/0003-second-thing.md +0 -0
- {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/two-briefs-open}/docs/briefs/0002-printing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/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-0.2.1 → formwork_kit-1.0.0}/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-0.2.1 → formwork_kit-1.0.0}/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-0.2.1/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report}/docs/briefs/0001-slow-login.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report/docs/briefs/0002-second-page-size.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/no-briefs-folder/README.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/run +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/git-boundary +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/protected-files +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/quality-gate +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/test_boundary.py +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/test_protection.py +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/test_quality_gate.py +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/architect.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/challenger.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/record-keeper.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/researcher.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/reviewer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/accessibility.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/ai.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/analyst.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/backend.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/brainstormer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/data.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/devops.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/frontend.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/integrations.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/legal.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/marketing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/mobile.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/performance.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/product.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/security.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/sre.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/tester.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/user-researcher.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/ux.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/visual.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/writer.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/round.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/setup +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/templates/decision.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/templates/predictions.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/templates/round.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/templates/standing.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/test_setup.py +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/troubleshooting.md +0 -0
- {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork_cli/__main__.py +0 -0
|
@@ -0,0 +1,50 @@
|
|
|
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
|
+
## 1.0.0
|
|
10
|
+
|
|
11
|
+
**This one can turn a green gate red.** Two checks are stricter and there is a
|
|
12
|
+
new core rule. By [`RELEASING.md`](RELEASING.md) that is a breaking change, so
|
|
13
|
+
the first number moves.
|
|
14
|
+
|
|
15
|
+
### Can turn your gate red
|
|
16
|
+
|
|
17
|
+
- `work-paired` allows one open brief at a time. Raise it with `open_briefs`
|
|
18
|
+
under `[strength]`, and 0 means no limit.
|
|
19
|
+
- `work-paired` refuses a brief marked `done` until its report carries
|
|
20
|
+
`accepted:` with a date and `in my words:` with a sentence.
|
|
21
|
+
- New check, `report-shape`: a report opens with `## For you`, a part for the
|
|
22
|
+
human, under 1,000 words and with no commands, before `## For the director`.
|
|
23
|
+
Reports written before the rule pass if they carry a dated `## For you`
|
|
24
|
+
bridge above their old headings.
|
|
25
|
+
|
|
26
|
+
### Added
|
|
27
|
+
|
|
28
|
+
- `formwork sync`. After upgrading the command, run it inside a project and
|
|
29
|
+
the project's `formwork/` and `FORMWORK.md` come up to the installed
|
|
30
|
+
release. Files the project owns stay: its own roles in the project pack, and
|
|
31
|
+
anything listed as `local` under `[bindings]` in `.formwork.toml`. It writes
|
|
32
|
+
the release into the project's SOURCE.txt and stops before recording the
|
|
33
|
+
fingerprints, because that is yours to do. `formwork/fw sync <project>` does
|
|
34
|
+
the same from a clean clone of the kit, pinned to the commit.
|
|
35
|
+
- `formwork/skills/`, and the first skill in it, `humanizer` 3.1.0, pinned to
|
|
36
|
+
one upstream commit with formwork's change to its rule on bold kept in a
|
|
37
|
+
separate file. `formwork roles` places it in `.claude/skills/` on Claude
|
|
38
|
+
Code, and `generated-current` goes red if that copy is edited by hand.
|
|
39
|
+
- `formwork/style.md`: text the agent writes as you, such as an email or a
|
|
40
|
+
comment, goes through `humanizer` first. A section on reports for two
|
|
41
|
+
readers.
|
|
42
|
+
- A fourteenth core rule: the human is not the courier.
|
|
43
|
+
- A role's `description`, `model`, `skills` and `color` reach the generated
|
|
44
|
+
Claude Code agent instead of being dropped. Codex and Gemini CLI get the
|
|
45
|
+
description and a note.
|
|
46
|
+
|
|
47
|
+
### Counts
|
|
48
|
+
|
|
49
|
+
Three guards, thirteen checks, twenty eight roles, forty eight rules, one
|
|
50
|
+
skill, 486 tests.
|
|
@@ -38,7 +38,10 @@ These do not ask you. They refuse.
|
|
|
38
38
|
| A turn does not end while the aggregate is red | `formwork/guard/quality-gate` |
|
|
39
39
|
| The standing brief is not older than the newest decision | `formwork/check/checks/standing-current` |
|
|
40
40
|
| Work marked finished left a report behind | `formwork/check/checks/work-paired` |
|
|
41
|
+
| Work marked finished carries the human's read-back, dated | `formwork/check/checks/work-paired` |
|
|
42
|
+
| One brief is open at a time, unless you raise the limit | `formwork/check/checks/work-paired` |
|
|
41
43
|
| Every generated role names the style page | `formwork/check/checks/style-pointed` |
|
|
44
|
+
| A report opens with a part for the human, under 1,000 words, no commands | `formwork/check/checks/report-shape` |
|
|
42
45
|
|
|
43
46
|
> [!NOTE]
|
|
44
47
|
> **The turn-end gate refuses three times in a session, then stands aside**, so
|
|
@@ -57,13 +60,33 @@ formwork check --list what exists
|
|
|
57
60
|
instead: `formwork/fw check`, `formwork/fw demo`, `formwork/fw roles`. Run
|
|
58
61
|
`formwork/fw` on its own to see the list.
|
|
59
62
|
|
|
63
|
+
**To bring a project's copy of the kit up to date**, upgrade the command, then
|
|
64
|
+
run this inside the project:
|
|
65
|
+
|
|
66
|
+
```
|
|
67
|
+
pipx install --force formwork-kit==X.Y.Z
|
|
68
|
+
formwork sync --dry-run see what would change
|
|
69
|
+
formwork sync copy, delete, pin
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
From a clone of the kit itself, which only the kit's maintainer needs, the
|
|
73
|
+
same thing is `formwork/fw sync <project>`, and it refuses unless the clone is
|
|
74
|
+
clean and committed.
|
|
75
|
+
|
|
76
|
+
It copies every kit file, deletes the ones the kit no longer has, and writes
|
|
77
|
+
the release, or the clone's commit, into the project's SOURCE.txt. It never touches the project's own
|
|
78
|
+
roles, the project pack, nor any path the project lists as its own in
|
|
79
|
+
`.formwork.toml`, under `[bindings]`, as `local = ["formwork/rules/core.md"]`.
|
|
80
|
+
It stops before recording the fingerprints, because that is your decision, and
|
|
81
|
+
prints the two commands to run yourself.
|
|
82
|
+
|
|
60
83
|
---
|
|
61
84
|
|
|
62
85
|
## What is advice
|
|
63
86
|
|
|
64
|
-
Everything else. **
|
|
87
|
+
Everything else. **48 rules**, in two files.
|
|
65
88
|
|
|
66
|
-
- `formwork/rules/core.md` holds
|
|
89
|
+
- `formwork/rules/core.md` holds 14. You meet these every day.
|
|
67
90
|
- `formwork/rules/full.md` holds 34. Read one when you hit the situation.
|
|
68
91
|
|
|
69
92
|
> [!TIP]
|
|
@@ -101,12 +124,13 @@ git_boundary = "block" # block | warn | off
|
|
|
101
124
|
protect_files = "block" # block | warn | off
|
|
102
125
|
aggregate_gate = "block" # the turn-end gate
|
|
103
126
|
gate_budget = 3 # refusals before it stands aside
|
|
127
|
+
open_briefs = 1 # briefs open at once, 0 for no limit
|
|
104
128
|
```
|
|
105
129
|
|
|
106
130
|
`[bindings]` is your setup. `[strength]` tunes how hard the enforced guards
|
|
107
131
|
bite. There is no third section: see above.
|
|
108
132
|
|
|
109
|
-
**The last
|
|
133
|
+
**The last three lines appear only once you change them.** They have working
|
|
110
134
|
defaults, so a fresh file is shorter than this.
|
|
111
135
|
|
|
112
136
|
**You do not have to write any of it by hand.** `formwork setup` asks a few
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: formwork-kit
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 1.0.0
|
|
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. 13 check(s), each shown to reject the wrong and accept the right.
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
<div align="center">
|
|
@@ -268,7 +268,7 @@ The copy is the whole kit, so you can delete `the-kit` afterwards. There is no
|
|
|
268
268
|
`init` step here, because copying the folder in **is** the init step.
|
|
269
269
|
|
|
270
270
|
`formwork check` becomes `formwork/fw check`, and the same for `install`,
|
|
271
|
-
`setup`, `demo`, `roles`, `record` and `
|
|
271
|
+
`setup`, `demo`, `roles`, `record`, `test` and `sync`. Run `formwork/fw` on its own for
|
|
272
272
|
the list. `where` and `version` belong to the installed command only.
|
|
273
273
|
|
|
274
274
|
### What each step does
|
|
@@ -278,7 +278,8 @@ the list. `where` and `version` belong to the installed command only.
|
|
|
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
280
|
| `setup` | asks eleven questions once, then writes your style file, your standing brief, and the folders for decisions, briefs and reports |
|
|
281
|
-
| `check` | runs all
|
|
281
|
+
| `check` | runs all thirteen checks and says green or red |
|
|
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 |
|
|
282
283
|
|
|
283
284
|
**What it touches.** It adds `formwork/` and `FORMWORK.md`, writes
|
|
284
285
|
`.formwork.toml`, writes your agent's settings file keeping anything already
|
|
@@ -383,10 +384,11 @@ in your own words, which beats it. Every role points at both.
|
|
|
383
384
|
| | | count it yourself |
|
|
384
385
|
|---|---|---|
|
|
385
386
|
| **3 guards** | small programs that refuse. Two stop a command, one stops a turn ending | `ls formwork/guard \| grep -v test_` |
|
|
386
|
-
| **
|
|
387
|
+
| **13 checks** | small programs that read your project and say green or red | `ls formwork/check/checks \| wc -l` |
|
|
387
388
|
| **28 roles** | one file each, saying what that job does and where it stops | `ls formwork/roles/*/*.md \| wc -l` |
|
|
388
|
-
| **
|
|
389
|
-
| **
|
|
389
|
+
| **48 rules** | 14 you meet daily, 34 for when you need them | `grep -c '^### ' formwork/rules/*.md` |
|
|
390
|
+
| **1 skill** | `humanizer`, pinned at one upstream commit, for text the agent writes as you | `ls formwork/skills` |
|
|
391
|
+
| **486 tests** | every guard and check, proved able to fail | `formwork test` |
|
|
390
392
|
|
|
391
393
|
It is all text files and small programs. You can read every line. Nothing is
|
|
392
394
|
hidden. Nothing is sent anywhere.
|
|
@@ -431,8 +433,8 @@ today:
|
|
|
431
433
|
|
|
432
434
|
| | |
|
|
433
435
|
|---|---|
|
|
434
|
-
| **
|
|
435
|
-
| **A model per role** |
|
|
436
|
+
| **More skills** | one so far, `humanizer`, in `formwork/skills/`, placed into `.claude/skills/` by `formwork roles`. Claude Code only. Where the other three read skills from is NOT ESTABLISHED, so there `style.md` tells the agent to read the file directly |
|
|
437
|
+
| **A model per role** | not a kit feature. What is built is narrower: a role may carry `model`, `skills` and `color`, and the generator passes them to Claude Code as written instead of dropping them. On the other three it writes a note, not a key. Effort level is not carried. Whether the other three have an equivalent is NOT ESTABLISHED |
|
|
436
438
|
| **Teams** | more than one person on the same standing brief. Today the method says one director at a time, and nobody has tried two |
|
|
437
439
|
| **Roles invented on the fly** | asked for by somebody who tried the kit. It cuts across the check that stops two roles owning one job, so it stays a question we have not settled |
|
|
438
440
|
|
|
@@ -467,6 +469,7 @@ better after you have run it once than before.
|
|
|
467
469
|
| [`style.md`](formwork/style.md) | how the agents talk to you, and how to change it |
|
|
468
470
|
| [`round.md`](formwork/round.md) | how to run a round, and when it is worth it |
|
|
469
471
|
| [`templates/`](formwork/templates/) | brief, predictions, report, decision, round, standing brief |
|
|
472
|
+
| [`skills/`](formwork/skills/) | skills the kit ships, each pinned to an upstream commit |
|
|
470
473
|
| [`roles/`](formwork/roles/) | the roles, and how to write your own |
|
|
471
474
|
| [`rules/`](formwork/rules/) | the rules, each saying what it catches |
|
|
472
475
|
|
|
@@ -486,6 +489,7 @@ better after you have run it once than before.
|
|
|
486
489
|
|---|---|
|
|
487
490
|
| [`docs/`](docs/) | the survey, the design, and what broke |
|
|
488
491
|
| [`docs/dogfood.md`](docs/dogfood.md) | the kit failing on its own author, written down |
|
|
492
|
+
| [`CHANGELOG.md`](CHANGELOG.md) | what changed in each release |
|
|
489
493
|
| [`RELEASING.md`](RELEASING.md) | for the maintainer |
|
|
490
494
|
|
|
491
495
|
---
|
|
@@ -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. 13 check(s), each shown to reject the wrong and accept the right.
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
<div align="center">
|
|
@@ -239,7 +239,7 @@ The copy is the whole kit, so you can delete `the-kit` afterwards. There is no
|
|
|
239
239
|
`init` step here, because copying the folder in **is** the init step.
|
|
240
240
|
|
|
241
241
|
`formwork check` becomes `formwork/fw check`, and the same for `install`,
|
|
242
|
-
`setup`, `demo`, `roles`, `record` and `
|
|
242
|
+
`setup`, `demo`, `roles`, `record`, `test` and `sync`. Run `formwork/fw` on its own for
|
|
243
243
|
the list. `where` and `version` belong to the installed command only.
|
|
244
244
|
|
|
245
245
|
### What each step does
|
|
@@ -249,7 +249,8 @@ the list. `where` and `version` belong to the installed command only.
|
|
|
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
251
|
| `setup` | asks eleven questions once, then writes your style file, your standing brief, and the folders for decisions, briefs and reports |
|
|
252
|
-
| `check` | runs all
|
|
252
|
+
| `check` | runs all thirteen checks and says green or red |
|
|
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 |
|
|
253
254
|
|
|
254
255
|
**What it touches.** It adds `formwork/` and `FORMWORK.md`, writes
|
|
255
256
|
`.formwork.toml`, writes your agent's settings file keeping anything already
|
|
@@ -354,10 +355,11 @@ in your own words, which beats it. Every role points at both.
|
|
|
354
355
|
| | | count it yourself |
|
|
355
356
|
|---|---|---|
|
|
356
357
|
| **3 guards** | small programs that refuse. Two stop a command, one stops a turn ending | `ls formwork/guard \| grep -v test_` |
|
|
357
|
-
| **
|
|
358
|
+
| **13 checks** | small programs that read your project and say green or red | `ls formwork/check/checks \| wc -l` |
|
|
358
359
|
| **28 roles** | one file each, saying what that job does and where it stops | `ls formwork/roles/*/*.md \| wc -l` |
|
|
359
|
-
| **
|
|
360
|
-
| **
|
|
360
|
+
| **48 rules** | 14 you meet daily, 34 for when you need them | `grep -c '^### ' formwork/rules/*.md` |
|
|
361
|
+
| **1 skill** | `humanizer`, pinned at one upstream commit, for text the agent writes as you | `ls formwork/skills` |
|
|
362
|
+
| **486 tests** | every guard and check, proved able to fail | `formwork test` |
|
|
361
363
|
|
|
362
364
|
It is all text files and small programs. You can read every line. Nothing is
|
|
363
365
|
hidden. Nothing is sent anywhere.
|
|
@@ -402,8 +404,8 @@ today:
|
|
|
402
404
|
|
|
403
405
|
| | |
|
|
404
406
|
|---|---|
|
|
405
|
-
| **
|
|
406
|
-
| **A model per role** |
|
|
407
|
+
| **More skills** | one so far, `humanizer`, in `formwork/skills/`, placed into `.claude/skills/` by `formwork roles`. Claude Code only. Where the other three read skills from is NOT ESTABLISHED, so there `style.md` tells the agent to read the file directly |
|
|
408
|
+
| **A model per role** | not a kit feature. What is built is narrower: a role may carry `model`, `skills` and `color`, and the generator passes them to Claude Code as written instead of dropping them. On the other three it writes a note, not a key. Effort level is not carried. Whether the other three have an equivalent is NOT ESTABLISHED |
|
|
407
409
|
| **Teams** | more than one person on the same standing brief. Today the method says one director at a time, and nobody has tried two |
|
|
408
410
|
| **Roles invented on the fly** | asked for by somebody who tried the kit. It cuts across the check that stops two roles owning one job, so it stays a question we have not settled |
|
|
409
411
|
|
|
@@ -438,6 +440,7 @@ better after you have run it once than before.
|
|
|
438
440
|
| [`style.md`](formwork/style.md) | how the agents talk to you, and how to change it |
|
|
439
441
|
| [`round.md`](formwork/round.md) | how to run a round, and when it is worth it |
|
|
440
442
|
| [`templates/`](formwork/templates/) | brief, predictions, report, decision, round, standing brief |
|
|
443
|
+
| [`skills/`](formwork/skills/) | skills the kit ships, each pinned to an upstream commit |
|
|
441
444
|
| [`roles/`](formwork/roles/) | the roles, and how to write your own |
|
|
442
445
|
| [`rules/`](formwork/rules/) | the rules, each saying what it catches |
|
|
443
446
|
|
|
@@ -457,6 +460,7 @@ better after you have run it once than before.
|
|
|
457
460
|
|---|---|
|
|
458
461
|
| [`docs/`](docs/) | the survey, the design, and what broke |
|
|
459
462
|
| [`docs/dogfood.md`](docs/dogfood.md) | the kit failing on its own author, written down |
|
|
463
|
+
| [`CHANGELOG.md`](CHANGELOG.md) | what changed in each release |
|
|
460
464
|
| [`RELEASING.md`](RELEASING.md) | for the maintainer |
|
|
461
465
|
|
|
462
466
|
---
|