formwork-kit 0.2.0__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.0 → formwork_kit-1.0.0}/FORMWORK.md +27 -3
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/PKG-INFO +26 -10
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/README.md +25 -9
- 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.0 → formwork_kit-1.0.0}/formwork/check/checks/role-shape +6 -1
- {formwork_kit-0.2.0 → 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.0 → 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.0/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.0/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.0 → 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.0 → 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.0 → formwork_kit-1.0.0}/formwork/first-run.md +16 -3
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/fw +8 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/glossary.md +1 -1
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/install +3 -2
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/limits.md +45 -10
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/loop.md +4 -2
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/HOW-TO-ADD-A-ROLE.md +7 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/TEMPLATE.md +15 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/director.md +68 -2
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/lead.md +5 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/rules/core.md +21 -1
- {formwork_kit-0.2.0 → 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.0 → formwork_kit-1.0.0}/formwork/style.md +34 -0
- formwork_kit-1.0.0/formwork/sync +315 -0
- {formwork_kit-0.2.0 → 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.0 → 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.0 → formwork_kit-1.0.0}/formwork/threads.md +17 -7
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork_cli/__init__.py +38 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/pyproject.toml +2 -2
- formwork_kit-0.2.0/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-a-second-answer.md +0 -3
- formwork_kit-0.2.0/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-slow-login.md +0 -3
- formwork_kit-0.2.0/formwork/check/test_gate.py +0 -222
- formwork_kit-0.2.0/formwork/templates/report.md +0 -58
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/.gitignore +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/LICENSE +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/COSTS.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/claude-code/README.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/claude-code/settings.json +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/codex/README.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/cursor/README.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/gemini-cli/README.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/config-shape +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/decision-ids +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/doc-links +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/generated-current +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/guard-wired +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/kit-integrity +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/predictions-first +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/rule-labels +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/standing-current +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/style-pointed +0 -0
- {formwork_kit-0.2.0 → 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.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-fail/rules-as-a-switchboard/.formwork.toml +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-pass/layers-kept-apart/.formwork.toml +0 -0
- {formwork_kit-0.2.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/never-written/index.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/renamed-file/architecture-notes.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/renamed-file/guide.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-pass/links-resolve/architecture-notes.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-pass/links-resolve/guide.md +0 -0
- {formwork_kit-0.2.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0/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.0/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.0 → 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.0 → 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.0/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.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/formwork/build +0 -0
- {formwork_kit-0.2.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/nothing-is-generated-here/README.md +0 -0
- {formwork_kit-0.2.0/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.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired/.claude/settings.json +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/guard-wired/must-pass/nothing-declared/README.md +0 -0
- {formwork_kit-0.2.0 → 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.0 → 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.0 → 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.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-pass/everything-matches/formwork/guard/git-boundary +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-pass/everything-matches/state/fingerprints.txt +0 -0
- {formwork_kit-0.2.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-pass/well-formed/formwork/roles/complete.md +0 -0
- {formwork_kit-0.2.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-fail/no-catches/formwork/rules/core.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-fail/unlabelled/formwork/rules/core.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-pass/well-formed/formwork/rules/core.md +0 -0
- {formwork_kit-0.2.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/no-standing-brief-here/README.md +0 -0
- {formwork_kit-0.2.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/nothing-generated-yet/formwork/style.md +0 -0
- {formwork_kit-0.2.0 → 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.0 → 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.0 → 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.0 → 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.0/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.0/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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0/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.0 → 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.0 → 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.0 → 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.0 → 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.0/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.0 → 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.0 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/no-briefs-folder/README.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/run +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/git-boundary +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/protected-files +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/quality-gate +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/test_boundary.py +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/test_protection.py +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/test_quality_gate.py +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/architect.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/challenger.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/record-keeper.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/researcher.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/reviewer.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/accessibility.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/ai.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/analyst.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/backend.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/brainstormer.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/data.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/devops.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/frontend.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/integrations.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/legal.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/marketing.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/mobile.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/performance.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/product.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/security.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/sre.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/tester.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/user-researcher.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/ux.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/visual.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/writer.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/round.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/setup +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/templates/decision.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/templates/predictions.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/templates/round.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/templates/standing.md +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/test_setup.py +0 -0
- {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/troubleshooting.md +0 -0
- {formwork_kit-0.2.0 → 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">
|
|
@@ -182,7 +182,19 @@ pipx install formwork-kit
|
|
|
182
182
|
```
|
|
183
183
|
|
|
184
184
|
pipx puts the `formwork` command on your path and keeps it in its own
|
|
185
|
-
environment, away from your project's packages.
|
|
185
|
+
environment, away from your project's packages.
|
|
186
|
+
|
|
187
|
+
> [!IMPORTANT]
|
|
188
|
+
> **If you used plain `pip` instead, `formwork` will say `command not found`.**
|
|
189
|
+
> It installed fine. pip put the command in a folder your shell does not
|
|
190
|
+
> search. You do not have to fix anything: put `python3 -m formwork_cli` in
|
|
191
|
+
> front of every command below and they all work.
|
|
192
|
+
>
|
|
193
|
+
> ```
|
|
194
|
+
> python3 -m formwork_cli init
|
|
195
|
+
> ```
|
|
196
|
+
|
|
197
|
+
Then, in your project:
|
|
186
198
|
|
|
187
199
|
```
|
|
188
200
|
cd /your/project
|
|
@@ -256,7 +268,7 @@ The copy is the whole kit, so you can delete `the-kit` afterwards. There is no
|
|
|
256
268
|
`init` step here, because copying the folder in **is** the init step.
|
|
257
269
|
|
|
258
270
|
`formwork check` becomes `formwork/fw check`, and the same for `install`,
|
|
259
|
-
`setup`, `demo`, `roles`, `record` and `
|
|
271
|
+
`setup`, `demo`, `roles`, `record`, `test` and `sync`. Run `formwork/fw` on its own for
|
|
260
272
|
the list. `where` and `version` belong to the installed command only.
|
|
261
273
|
|
|
262
274
|
### What each step does
|
|
@@ -266,7 +278,8 @@ the list. `where` and `version` belong to the installed command only.
|
|
|
266
278
|
| `init` | puts `formwork/` and `FORMWORK.md` into your project |
|
|
267
279
|
| `install` | wires the guards into your agent, writes your role files. Add `--runtime <name>` when it cannot tell |
|
|
268
280
|
| `setup` | asks eleven questions once, then writes your style file, your standing brief, and the folders for decisions, briefs and reports |
|
|
269
|
-
| `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 |
|
|
270
283
|
|
|
271
284
|
**What it touches.** It adds `formwork/` and `FORMWORK.md`, writes
|
|
272
285
|
`.formwork.toml`, writes your agent's settings file keeping anything already
|
|
@@ -371,10 +384,11 @@ in your own words, which beats it. Every role points at both.
|
|
|
371
384
|
| | | count it yourself |
|
|
372
385
|
|---|---|---|
|
|
373
386
|
| **3 guards** | small programs that refuse. Two stop a command, one stops a turn ending | `ls formwork/guard \| grep -v test_` |
|
|
374
|
-
| **
|
|
387
|
+
| **13 checks** | small programs that read your project and say green or red | `ls formwork/check/checks \| wc -l` |
|
|
375
388
|
| **28 roles** | one file each, saying what that job does and where it stops | `ls formwork/roles/*/*.md \| wc -l` |
|
|
376
|
-
| **
|
|
377
|
-
| **
|
|
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` |
|
|
378
392
|
|
|
379
393
|
It is all text files and small programs. You can read every line. Nothing is
|
|
380
394
|
hidden. Nothing is sent anywhere.
|
|
@@ -419,8 +433,8 @@ today:
|
|
|
419
433
|
|
|
420
434
|
| | |
|
|
421
435
|
|---|---|
|
|
422
|
-
| **
|
|
423
|
-
| **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 |
|
|
424
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 |
|
|
425
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 |
|
|
426
440
|
|
|
@@ -455,6 +469,7 @@ better after you have run it once than before.
|
|
|
455
469
|
| [`style.md`](formwork/style.md) | how the agents talk to you, and how to change it |
|
|
456
470
|
| [`round.md`](formwork/round.md) | how to run a round, and when it is worth it |
|
|
457
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 |
|
|
458
473
|
| [`roles/`](formwork/roles/) | the roles, and how to write your own |
|
|
459
474
|
| [`rules/`](formwork/rules/) | the rules, each saying what it catches |
|
|
460
475
|
|
|
@@ -474,6 +489,7 @@ better after you have run it once than before.
|
|
|
474
489
|
|---|---|
|
|
475
490
|
| [`docs/`](docs/) | the survey, the design, and what broke |
|
|
476
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 |
|
|
477
493
|
| [`RELEASING.md`](RELEASING.md) | for the maintainer |
|
|
478
494
|
|
|
479
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">
|
|
@@ -153,7 +153,19 @@ pipx install formwork-kit
|
|
|
153
153
|
```
|
|
154
154
|
|
|
155
155
|
pipx puts the `formwork` command on your path and keeps it in its own
|
|
156
|
-
environment, away from your project's packages.
|
|
156
|
+
environment, away from your project's packages.
|
|
157
|
+
|
|
158
|
+
> [!IMPORTANT]
|
|
159
|
+
> **If you used plain `pip` instead, `formwork` will say `command not found`.**
|
|
160
|
+
> It installed fine. pip put the command in a folder your shell does not
|
|
161
|
+
> search. You do not have to fix anything: put `python3 -m formwork_cli` in
|
|
162
|
+
> front of every command below and they all work.
|
|
163
|
+
>
|
|
164
|
+
> ```
|
|
165
|
+
> python3 -m formwork_cli init
|
|
166
|
+
> ```
|
|
167
|
+
|
|
168
|
+
Then, in your project:
|
|
157
169
|
|
|
158
170
|
```
|
|
159
171
|
cd /your/project
|
|
@@ -227,7 +239,7 @@ The copy is the whole kit, so you can delete `the-kit` afterwards. There is no
|
|
|
227
239
|
`init` step here, because copying the folder in **is** the init step.
|
|
228
240
|
|
|
229
241
|
`formwork check` becomes `formwork/fw check`, and the same for `install`,
|
|
230
|
-
`setup`, `demo`, `roles`, `record` and `
|
|
242
|
+
`setup`, `demo`, `roles`, `record`, `test` and `sync`. Run `formwork/fw` on its own for
|
|
231
243
|
the list. `where` and `version` belong to the installed command only.
|
|
232
244
|
|
|
233
245
|
### What each step does
|
|
@@ -237,7 +249,8 @@ the list. `where` and `version` belong to the installed command only.
|
|
|
237
249
|
| `init` | puts `formwork/` and `FORMWORK.md` into your project |
|
|
238
250
|
| `install` | wires the guards into your agent, writes your role files. Add `--runtime <name>` when it cannot tell |
|
|
239
251
|
| `setup` | asks eleven questions once, then writes your style file, your standing brief, and the folders for decisions, briefs and reports |
|
|
240
|
-
| `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 |
|
|
241
254
|
|
|
242
255
|
**What it touches.** It adds `formwork/` and `FORMWORK.md`, writes
|
|
243
256
|
`.formwork.toml`, writes your agent's settings file keeping anything already
|
|
@@ -342,10 +355,11 @@ in your own words, which beats it. Every role points at both.
|
|
|
342
355
|
| | | count it yourself |
|
|
343
356
|
|---|---|---|
|
|
344
357
|
| **3 guards** | small programs that refuse. Two stop a command, one stops a turn ending | `ls formwork/guard \| grep -v test_` |
|
|
345
|
-
| **
|
|
358
|
+
| **13 checks** | small programs that read your project and say green or red | `ls formwork/check/checks \| wc -l` |
|
|
346
359
|
| **28 roles** | one file each, saying what that job does and where it stops | `ls formwork/roles/*/*.md \| wc -l` |
|
|
347
|
-
| **
|
|
348
|
-
| **
|
|
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` |
|
|
349
363
|
|
|
350
364
|
It is all text files and small programs. You can read every line. Nothing is
|
|
351
365
|
hidden. Nothing is sent anywhere.
|
|
@@ -390,8 +404,8 @@ today:
|
|
|
390
404
|
|
|
391
405
|
| | |
|
|
392
406
|
|---|---|
|
|
393
|
-
| **
|
|
394
|
-
| **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 |
|
|
395
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 |
|
|
396
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 |
|
|
397
411
|
|
|
@@ -426,6 +440,7 @@ better after you have run it once than before.
|
|
|
426
440
|
| [`style.md`](formwork/style.md) | how the agents talk to you, and how to change it |
|
|
427
441
|
| [`round.md`](formwork/round.md) | how to run a round, and when it is worth it |
|
|
428
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 |
|
|
429
444
|
| [`roles/`](formwork/roles/) | the roles, and how to write your own |
|
|
430
445
|
| [`rules/`](formwork/rules/) | the rules, each saying what it catches |
|
|
431
446
|
|
|
@@ -445,6 +460,7 @@ better after you have run it once than before.
|
|
|
445
460
|
|---|---|
|
|
446
461
|
| [`docs/`](docs/) | the survey, the design, and what broke |
|
|
447
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 |
|
|
448
464
|
| [`RELEASING.md`](RELEASING.md) | for the maintainer |
|
|
449
465
|
|
|
450
466
|
---
|