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.
Files changed (251) hide show
  1. formwork_kit-1.0.0/CHANGELOG.md +50 -0
  2. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/FORMWORK.md +27 -3
  3. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/PKG-INFO +26 -10
  4. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/README.md +25 -9
  5. formwork_kit-1.0.0/formwork/build +622 -0
  6. formwork_kit-1.0.0/formwork/check/checks/report-shape +200 -0
  7. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/role-shape +6 -1
  8. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/work-paired +98 -4
  9. formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.claude/agents/sample.md +27 -0
  10. formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.codex/agents/sample.toml +26 -0
  11. formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/.gemini/agents/sample.md +27 -0
  12. {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
  13. formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand/formwork/roles/method/sample.md +24 -0
  14. formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.claude/agents/sample.md +27 -0
  15. formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.codex/agents/sample.toml +26 -0
  16. formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/.gemini/agents/sample.md +27 -0
  17. formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/formwork/build +530 -0
  18. formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color/formwork/roles/method/sample.md +24 -0
  19. formwork_kit-1.0.0/formwork/check/fixtures/guard-wired/must-fail/file-but-not-wired/.formwork.toml +1 -0
  20. formwork_kit-1.0.0/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired/.formwork.toml +1 -0
  21. 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
  22. 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
  23. formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-fail/over-the-ceiling/docs/reports/0001-slow-login.md +61 -0
  24. formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-fail/the-director-comes-first/docs/reports/0001-slow-login.md +49 -0
  25. 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
  26. formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-pass/no-reports-folder/README.md +1 -0
  27. formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-pass/the-task-version/docs/reports/0002-rename-foo.md +13 -0
  28. formwork_kit-1.0.0/formwork/check/fixtures/report-shape/must-pass/two-parts-in-order/docs/reports/0001-slow-login.md +48 -0
  29. {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
  30. {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
  31. formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/two-briefs-open/docs/briefs/0001-slow-login.md +18 -0
  32. 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
  33. formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-slow-login.md +6 -0
  34. {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
  35. {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
  36. formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/limit-raised-to-two/.formwork.toml +5 -0
  37. formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/limit-raised-to-two/docs/briefs/0001-slow-login.md +18 -0
  38. formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/limit-raised-to-two/docs/briefs/0002-printing.md +18 -0
  39. 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
  40. 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
  41. 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
  42. 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
  43. formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine/docs/briefs/0002-printing.md +18 -0
  44. 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
  45. formwork_kit-1.0.0/formwork/check/test_gate.py +407 -0
  46. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/first-run.md +16 -3
  47. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/fw +8 -0
  48. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/glossary.md +1 -1
  49. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/install +3 -2
  50. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/limits.md +45 -10
  51. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/loop.md +4 -2
  52. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/HOW-TO-ADD-A-ROLE.md +7 -0
  53. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/TEMPLATE.md +15 -0
  54. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/director.md +68 -2
  55. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/lead.md +5 -0
  56. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/rules/core.md +21 -1
  57. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/rules/full.md +1 -1
  58. formwork_kit-1.0.0/formwork/skills/humanizer/LICENSE +21 -0
  59. formwork_kit-1.0.0/formwork/skills/humanizer/SKILL.md +397 -0
  60. formwork_kit-1.0.0/formwork/skills/humanizer/UPSTREAM.md +29 -0
  61. formwork_kit-1.0.0/formwork/skills/humanizer/local.md +11 -0
  62. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/style.md +34 -0
  63. formwork_kit-1.0.0/formwork/sync +315 -0
  64. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/templates/brief.md +3 -0
  65. formwork_kit-1.0.0/formwork/templates/report.md +127 -0
  66. formwork_kit-1.0.0/formwork/test_build.py +257 -0
  67. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/test_install.py +8 -2
  68. formwork_kit-1.0.0/formwork/test_sync.py +274 -0
  69. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/threads.md +17 -7
  70. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork_cli/__init__.py +38 -0
  71. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/pyproject.toml +2 -2
  72. 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
  73. formwork_kit-0.2.0/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-slow-login.md +0 -3
  74. formwork_kit-0.2.0/formwork/check/test_gate.py +0 -222
  75. formwork_kit-0.2.0/formwork/templates/report.md +0 -58
  76. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/.gitignore +0 -0
  77. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/LICENSE +0 -0
  78. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/COSTS.md +0 -0
  79. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/claude-code/README.md +0 -0
  80. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/claude-code/settings.json +0 -0
  81. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/codex/README.md +0 -0
  82. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/cursor/README.md +0 -0
  83. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/adapters/gemini-cli/README.md +0 -0
  84. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/config-shape +0 -0
  85. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/decision-ids +0 -0
  86. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/doc-links +0 -0
  87. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/generated-current +0 -0
  88. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/guard-wired +0 -0
  89. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/kit-integrity +0 -0
  90. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/predictions-first +0 -0
  91. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/rule-labels +0 -0
  92. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/standing-current +0 -0
  93. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/checks/style-pointed +0 -0
  94. {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
  95. {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
  96. {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
  97. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-pass/layers-kept-apart/.formwork.toml +0 -0
  98. {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
  99. {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
  100. {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
  101. {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
  102. {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
  103. {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
  104. {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
  105. {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
  106. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/never-written/index.md +0 -0
  107. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/renamed-file/architecture-notes.md +0 -0
  108. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/renamed-file/guide.md +0 -0
  109. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-pass/links-resolve/architecture-notes.md +0 -0
  110. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-pass/links-resolve/guide.md +0 -0
  111. {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
  112. {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
  113. {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
  114. {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
  115. {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
  116. {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
  117. {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
  118. {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
  119. {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
  120. {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
  121. {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
  122. {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
  123. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/formwork/build +0 -0
  124. {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
  125. {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
  126. {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
  127. {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
  128. {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
  129. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/guard-wired/must-pass/nothing-declared/README.md +0 -0
  130. {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
  131. {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
  132. {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
  133. {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
  134. {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
  135. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-pass/everything-matches/state/fingerprints.txt +0 -0
  136. {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
  137. {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
  138. {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
  139. {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
  140. {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
  141. {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
  142. {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
  143. {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
  144. {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
  145. {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
  146. {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
  147. {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
  148. {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
  149. {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
  150. {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
  151. {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
  152. {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
  153. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-fail/unlabelled/formwork/rules/core.md +0 -0
  154. {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
  155. {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
  156. {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
  157. {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
  158. {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
  159. {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
  160. {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
  161. {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
  162. {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
  163. {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
  164. {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
  165. {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
  166. {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
  167. {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
  168. {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
  169. {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
  170. {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
  171. {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
  172. {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
  173. {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
  174. {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
  175. {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
  176. {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
  177. {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
  178. {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
  179. {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
  180. {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
  181. {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
  182. {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
  183. {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
  184. {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
  185. {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
  186. {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
  187. {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
  188. {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
  189. {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
  190. {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
  191. {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
  192. {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
  193. {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
  194. {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
  195. {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
  196. {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
  197. {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
  198. {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
  199. {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
  200. {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
  201. {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
  202. {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
  203. {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
  204. {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
  205. {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
  206. {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
  207. {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
  208. {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
  209. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/no-briefs-folder/README.md +0 -0
  210. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/check/run +0 -0
  211. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/git-boundary +0 -0
  212. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/protected-files +0 -0
  213. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/quality-gate +0 -0
  214. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/test_boundary.py +0 -0
  215. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/test_protection.py +0 -0
  216. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/guard/test_quality_gate.py +0 -0
  217. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/architect.md +0 -0
  218. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/challenger.md +0 -0
  219. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/record-keeper.md +0 -0
  220. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/researcher.md +0 -0
  221. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/method/reviewer.md +0 -0
  222. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/accessibility.md +0 -0
  223. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/ai.md +0 -0
  224. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/analyst.md +0 -0
  225. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/backend.md +0 -0
  226. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/brainstormer.md +0 -0
  227. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/data.md +0 -0
  228. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/devops.md +0 -0
  229. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/frontend.md +0 -0
  230. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/integrations.md +0 -0
  231. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/legal.md +0 -0
  232. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/marketing.md +0 -0
  233. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/mobile.md +0 -0
  234. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/performance.md +0 -0
  235. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/product.md +0 -0
  236. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/security.md +0 -0
  237. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/sre.md +0 -0
  238. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/tester.md +0 -0
  239. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/user-researcher.md +0 -0
  240. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/ux.md +0 -0
  241. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/visual.md +0 -0
  242. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/roles/packs/writer.md +0 -0
  243. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/round.md +0 -0
  244. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/setup +0 -0
  245. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/templates/decision.md +0 -0
  246. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/templates/predictions.md +0 -0
  247. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/templates/round.md +0 -0
  248. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/templates/standing.md +0 -0
  249. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/test_setup.py +0 -0
  250. {formwork_kit-0.2.0 → formwork_kit-1.0.0}/formwork/troubleshooting.md +0 -0
  251. {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. **47 rules**, in two files.
87
+ Everything else. **48 rules**, in two files.
65
88
 
66
- - `formwork/rules/core.md` holds 13. You meet these every day.
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 two lines appear only once you change them.** They have working
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.2.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. 12 check(s), each shown to reject the wrong and accept the right.
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. Then, in your project:
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 `test`. Run `formwork/fw` on its own for
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 twelve checks and says green or red |
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
- | **12 checks** | small programs that read your project and say green or red | `ls formwork/check/checks \| wc -l` |
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
- | **47 rules** | 13 you meet daily, 34 for when you need them | `grep -c '^### ' formwork/rules/*.md` |
377
- | **356 tests** | every guard and check, proved able to fail | `formwork test` |
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
- | **Skills** | one word for a common job, instead of a paragraph. Considered, not started |
423
- | **A model per role** | pick the model and effort level for each role. Only Claude Code is known to allow it. Nobody has checked the other three, so this would be one agent out of four until somebody does |
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. 12 check(s), each shown to reject the wrong and accept the right.
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. Then, in your project:
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 `test`. Run `formwork/fw` on its own for
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 twelve checks and says green or red |
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
- | **12 checks** | small programs that read your project and say green or red | `ls formwork/check/checks \| wc -l` |
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
- | **47 rules** | 13 you meet daily, 34 for when you need them | `grep -c '^### ' formwork/rules/*.md` |
348
- | **356 tests** | every guard and check, proved able to fail | `formwork test` |
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
- | **Skills** | one word for a common job, instead of a paragraph. Considered, not started |
394
- | **A model per role** | pick the model and effort level for each role. Only Claude Code is known to allow it. Nobody has checked the other three, so this would be one agent out of four until somebody does |
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
  ---