formwork-kit 0.2.1__tar.gz → 1.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (251) hide show
  1. formwork_kit-1.0.0/CHANGELOG.md +50 -0
  2. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/FORMWORK.md +27 -3
  3. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/PKG-INFO +13 -9
  4. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/README.md +12 -8
  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.1 → formwork_kit-1.0.0}/formwork/check/checks/role-shape +6 -1
  8. {formwork_kit-0.2.1 → 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.1 → 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.1/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing}/docs/reports/0001-slow-login.md +3 -0
  30. {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/done-without-read-back}/docs/reports/0001-slow-login.md +2 -0
  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.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/a-round-is-one-brief-like-any-other/docs/reports/0001-storage-shape.md +3 -0
  35. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report/docs/reports/0001-slow-login.md +3 -0
  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.1 → formwork_kit-1.0.0}/formwork/first-run.md +12 -1
  47. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/fw +8 -0
  48. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/glossary.md +1 -1
  49. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/install +3 -2
  50. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/limits.md +25 -0
  51. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/loop.md +4 -2
  52. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/HOW-TO-ADD-A-ROLE.md +7 -0
  53. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/TEMPLATE.md +15 -0
  54. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/director.md +45 -2
  55. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/lead.md +5 -0
  56. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/rules/core.md +21 -1
  57. {formwork_kit-0.2.1 → 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.1 → 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.1 → 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.1 → 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.1 → formwork_kit-1.0.0}/formwork/threads.md +17 -7
  70. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork_cli/__init__.py +38 -0
  71. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/pyproject.toml +2 -2
  72. formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-a-second-answer.md +0 -3
  73. formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/reports/0001-slow-login.md +0 -3
  74. formwork_kit-0.2.1/formwork/check/test_gate.py +0 -222
  75. formwork_kit-0.2.1/formwork/templates/report.md +0 -58
  76. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/.gitignore +0 -0
  77. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/LICENSE +0 -0
  78. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/COSTS.md +0 -0
  79. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/claude-code/README.md +0 -0
  80. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/claude-code/settings.json +0 -0
  81. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/codex/README.md +0 -0
  82. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/cursor/README.md +0 -0
  83. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/adapters/gemini-cli/README.md +0 -0
  84. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/config-shape +0 -0
  85. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/decision-ids +0 -0
  86. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/doc-links +0 -0
  87. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/generated-current +0 -0
  88. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/guard-wired +0 -0
  89. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/kit-integrity +0 -0
  90. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/predictions-first +0 -0
  91. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/rule-labels +0 -0
  92. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/standing-current +0 -0
  93. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/checks/style-pointed +0 -0
  94. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-fail/documents-a-section-that-does-not-exist/.formwork.toml +0 -0
  95. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-fail/documents-a-section-that-does-not-exist/formwork/guide.md +0 -0
  96. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-fail/rules-as-a-switchboard/.formwork.toml +0 -0
  97. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/config-shape/must-pass/layers-kept-apart/.formwork.toml +0 -0
  98. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-fail/a-placeholder-shipped/docs/decisions/0003-still-pending.md +0 -0
  99. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-fail/superseded-by-nothing/docs/decisions/0002-old.md +0 -0
  100. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-fail/two-decisions-one-number/docs/decisions/0007-first.md +0 -0
  101. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-fail/two-decisions-one-number/docs/decisions/0007-second.md +0 -0
  102. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-pass/clean-numbering/docs/decisions/0001-the-first.md +0 -0
  103. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-pass/clean-numbering/docs/decisions/0002-the-second.md +0 -0
  104. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-pass/clean-numbering/docs/decisions/0003-the-third.md +0 -0
  105. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/decision-ids/must-pass/nothing-recorded-yet/docs/decisions/README.md +0 -0
  106. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/never-written/index.md +0 -0
  107. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/renamed-file/architecture-notes.md +0 -0
  108. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-fail/renamed-file/guide.md +0 -0
  109. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-pass/links-resolve/architecture-notes.md +0 -0
  110. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/doc-links/must-pass/links-resolve/guide.md +0 -0
  111. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.claude/agents/sample.md +0 -0
  112. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.codex/agents/sample.toml +0 -0
  113. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.formwork.toml +0 -0
  114. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/.gemini/agents/sample.md +0 -0
  115. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/formwork/build +0 -0
  116. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-fail/a-generated-file-was-edited/formwork/roles/method/sample.md +0 -0
  117. {formwork_kit-0.2.1/formwork/check/fixtures/generated-current/must-pass/generated-and-current → formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-fail/model-line-edited-by-hand}/.formwork.toml +0 -0
  118. {formwork_kit-0.2.1/formwork/check/fixtures/guard-wired/must-fail/declared-but-no-file → formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/carries-model-skills-and-color}/.formwork.toml +0 -0
  119. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.claude/agents/sample.md +0 -0
  120. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.codex/agents/sample.toml +0 -0
  121. {formwork_kit-0.2.1/formwork/check/fixtures/guard-wired/must-fail/file-but-not-wired → formwork_kit-1.0.0/formwork/check/fixtures/generated-current/must-pass/generated-and-current}/.formwork.toml +0 -0
  122. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/.gemini/agents/sample.md +0 -0
  123. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/formwork/build +0 -0
  124. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/generated-and-current/formwork/roles/method/sample.md +0 -0
  125. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/generated-current/must-pass/nothing-is-generated-here/README.md +0 -0
  126. {formwork_kit-0.2.1/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired → formwork_kit-1.0.0/formwork/check/fixtures/guard-wired/must-fail/declared-but-no-file}/.formwork.toml +0 -0
  127. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/guard-wired/must-fail/file-but-not-wired/.claude/settings.json +0 -0
  128. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/guard-wired/must-pass/declared-and-wired/.claude/settings.json +0 -0
  129. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/guard-wired/must-pass/nothing-declared/README.md +0 -0
  130. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-fail/a-check-went-missing/formwork/check/checks/still-here +0 -0
  131. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-fail/a-check-went-missing/state/fingerprints.txt +0 -0
  132. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-fail/a-guard-was-altered/formwork/guard/git-boundary +0 -0
  133. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-fail/a-guard-was-altered/state/fingerprints.txt +0 -0
  134. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-pass/everything-matches/formwork/guard/git-boundary +0 -0
  135. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/kit-integrity/must-pass/everything-matches/state/fingerprints.txt +0 -0
  136. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-fail/argued-with-no-predictions/docs/rounds/0004-the-storage-question/architect.md +0 -0
  137. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-fail/argued-with-no-predictions/docs/rounds/0004-the-storage-question/researcher.md +0 -0
  138. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-fail/argued-with-no-predictions/docs/rounds/0004-the-storage-question/round.md +0 -0
  139. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-pass/a-round-that-has-not-argued-yet/docs/rounds/0006-not-started/round.md +0 -0
  140. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-pass/no-rounds-at-all/docs/README.md +0 -0
  141. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-pass/predictions-on-record/docs/rounds/0005-the-shape-of-a-brief/architect.md +0 -0
  142. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-pass/predictions-on-record/docs/rounds/0005-the-shape-of-a-brief/predictions.md +0 -0
  143. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/predictions-first/must-pass/predictions-on-record/docs/rounds/0005-the-shape-of-a-brief/researcher.md +0 -0
  144. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/claims-a-grant-binds-everywhere/formwork/roles/README.md +0 -0
  145. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/claims-a-grant-binds-everywhere/formwork/roles/complete.md +0 -0
  146. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/missing-a-section/formwork/roles/vague.md +0 -0
  147. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/spawn-without-being-lead/formwork/roles/eager.md +0 -0
  148. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/two-roles-one-job/formwork/roles/first.md +0 -0
  149. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-fail/two-roles-one-job/formwork/roles/second.md +0 -0
  150. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/role-shape/must-pass/well-formed/formwork/roles/complete.md +0 -0
  151. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-fail/claims-enforcement-that-does-not-exist/formwork/rules/core.md +0 -0
  152. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-fail/no-catches/formwork/rules/core.md +0 -0
  153. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-fail/unlabelled/formwork/rules/core.md +0 -0
  154. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/rule-labels/must-pass/well-formed/formwork/rules/core.md +0 -0
  155. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-decision-hides-in-a-subfolder/docs/decisions/2026/0002-second-page-size.md +0 -0
  156. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-decision-hides-in-a-subfolder/docs/standing.md +0 -0
  157. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-decision-is-newer-than-the-brief/docs/decisions/0002-second-page-size.md +0 -0
  158. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-decision-is-newer-than-the-brief/docs/standing.md +0 -0
  159. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-round-record-has-no-date/docs/rounds/page-size/record.md +0 -0
  160. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/a-round-record-has-no-date/docs/standing.md +0 -0
  161. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/the-brief-carries-no-date/docs/standing.md +0 -0
  162. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/the-brief-is-only-an-example/docs/standing.md +0 -0
  163. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-fail/the-template-was-never-filled-in/docs/standing.md +0 -0
  164. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/a-quoted-diff-is-not-an-empty-bullet/docs/standing.md +0 -0
  165. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-ahead-of-the-record/docs/decisions/0001-one-page-size.md +0 -0
  166. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-ahead-of-the-record/docs/rounds/page-size/record.md +0 -0
  167. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-ahead-of-the-record/docs/standing.md +0 -0
  168. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/filled-in-and-nothing-else-recorded/docs/standing.md +0 -0
  169. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/no-standing-brief-here/README.md +0 -0
  170. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/standing-current/must-pass/no-standing-brief-here/docs/notes.md +0 -0
  171. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/a-role-in-a-subfolder/.claude/agents/team/writer.md +0 -0
  172. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/a-role-in-a-subfolder/formwork/style.md +0 -0
  173. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/a-word-that-merely-contains-it/.claude/agents/writer.md +0 -0
  174. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/a-word-that-merely-contains-it/formwork/style.md +0 -0
  175. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/one-runtime-was-left-behind/.claude/agents/writer.md +0 -0
  176. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/one-runtime-was-left-behind/.gemini/agents/writer.md +0 -0
  177. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/one-runtime-was-left-behind/formwork/style.md +0 -0
  178. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/the-pointer-went-missing/.claude/agents/tester.md +0 -0
  179. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/the-pointer-went-missing/.claude/agents/writer.md +0 -0
  180. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-fail/the-pointer-went-missing/formwork/style.md +0 -0
  181. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/a-readme-among-the-roles/.claude/agents/README.md +0 -0
  182. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/a-readme-among-the-roles/.claude/agents/writer.md +0 -0
  183. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/a-readme-among-the-roles/formwork/style.md +0 -0
  184. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.claude/agents/tester.md +0 -0
  185. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.claude/agents/writer.md +0 -0
  186. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.codex/agents/writer.toml +0 -0
  187. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/.gemini/agents/writer.md +0 -0
  188. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/every-role-points-at-it/formwork/style.md +0 -0
  189. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/no-style-page-here/.claude/agents/writer.md +0 -0
  190. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/style-pointed/must-pass/nothing-generated-yet/formwork/style.md +0 -0
  191. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/a-nested-status-hides-the-real-one/docs/briefs/0001-slow-login.md +0 -0
  192. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing/docs/briefs/0001-slow-login.md +0 -0
  193. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/a-report-for-nothing/docs/reports/0009-a-brief-nobody-wrote.md +0 -0
  194. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/a-status-nobody-can-read/docs/briefs/0002-something.md +0 -0
  195. {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-fail/finished-and-left-no-report → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/done-without-read-back}/docs/briefs/0001-slow-login.md +0 -0
  196. {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/finished-and-left-no-report}/docs/briefs/0001-slow-login.md +0 -0
  197. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/finished-and-left-no-report/docs/reports/README.md +0 -0
  198. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/the-report-is-empty/docs/briefs/0001-slow-login.md +0 -0
  199. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/the-report-is-empty/docs/reports/0001-slow-login.md +0 -0
  200. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/two-briefs-one-number/docs/briefs/0003-first-thing.md +0 -0
  201. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/two-briefs-one-number/docs/briefs/0003-second-thing.md +0 -0
  202. {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-fail/two-briefs-open}/docs/briefs/0002-printing.md +0 -0
  203. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-fail/two-reports-one-number/docs/briefs/0001-slow-login.md +0 -0
  204. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/a-round-is-one-brief-like-any-other/docs/briefs/0001-storage-shape.md +0 -0
  205. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/a-round-is-one-brief-like-any-other/docs/rounds/storage-shape/predictions.md +0 -0
  206. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/a-round-is-one-brief-like-any-other/docs/rounds/storage-shape/round.md +0 -0
  207. {formwork_kit-0.2.1/formwork/check/fixtures/work-paired/must-pass/work-still-open-is-fine → formwork_kit-1.0.0/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report}/docs/briefs/0001-slow-login.md +0 -0
  208. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/finished-work-has-its-report/docs/briefs/0002-second-page-size.md +0 -0
  209. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/fixtures/work-paired/must-pass/no-briefs-folder/README.md +0 -0
  210. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/check/run +0 -0
  211. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/git-boundary +0 -0
  212. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/protected-files +0 -0
  213. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/quality-gate +0 -0
  214. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/test_boundary.py +0 -0
  215. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/test_protection.py +0 -0
  216. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/guard/test_quality_gate.py +0 -0
  217. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/architect.md +0 -0
  218. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/challenger.md +0 -0
  219. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/record-keeper.md +0 -0
  220. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/researcher.md +0 -0
  221. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/method/reviewer.md +0 -0
  222. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/accessibility.md +0 -0
  223. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/ai.md +0 -0
  224. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/analyst.md +0 -0
  225. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/backend.md +0 -0
  226. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/brainstormer.md +0 -0
  227. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/data.md +0 -0
  228. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/devops.md +0 -0
  229. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/frontend.md +0 -0
  230. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/integrations.md +0 -0
  231. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/legal.md +0 -0
  232. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/marketing.md +0 -0
  233. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/mobile.md +0 -0
  234. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/performance.md +0 -0
  235. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/product.md +0 -0
  236. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/security.md +0 -0
  237. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/sre.md +0 -0
  238. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/tester.md +0 -0
  239. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/user-researcher.md +0 -0
  240. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/ux.md +0 -0
  241. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/visual.md +0 -0
  242. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/roles/packs/writer.md +0 -0
  243. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/round.md +0 -0
  244. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/setup +0 -0
  245. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/templates/decision.md +0 -0
  246. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/templates/predictions.md +0 -0
  247. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/templates/round.md +0 -0
  248. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/templates/standing.md +0 -0
  249. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/test_setup.py +0 -0
  250. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork/troubleshooting.md +0 -0
  251. {formwork_kit-0.2.1 → formwork_kit-1.0.0}/formwork_cli/__main__.py +0 -0
@@ -0,0 +1,50 @@
1
+ # Changelog
2
+
3
+ What changed in each release, newest first. Before 1.0.0 the record is the
4
+ version commit's message in git: `git show 02bd5f0` for 0.2.0 and
5
+ `git show 6a923da` for 0.2.1.
6
+
7
+ ---
8
+
9
+ ## 1.0.0
10
+
11
+ **This one can turn a green gate red.** Two checks are stricter and there is a
12
+ new core rule. By [`RELEASING.md`](RELEASING.md) that is a breaking change, so
13
+ the first number moves.
14
+
15
+ ### Can turn your gate red
16
+
17
+ - `work-paired` allows one open brief at a time. Raise it with `open_briefs`
18
+ under `[strength]`, and 0 means no limit.
19
+ - `work-paired` refuses a brief marked `done` until its report carries
20
+ `accepted:` with a date and `in my words:` with a sentence.
21
+ - New check, `report-shape`: a report opens with `## For you`, a part for the
22
+ human, under 1,000 words and with no commands, before `## For the director`.
23
+ Reports written before the rule pass if they carry a dated `## For you`
24
+ bridge above their old headings.
25
+
26
+ ### Added
27
+
28
+ - `formwork sync`. After upgrading the command, run it inside a project and
29
+ the project's `formwork/` and `FORMWORK.md` come up to the installed
30
+ release. Files the project owns stay: its own roles in the project pack, and
31
+ anything listed as `local` under `[bindings]` in `.formwork.toml`. It writes
32
+ the release into the project's SOURCE.txt and stops before recording the
33
+ fingerprints, because that is yours to do. `formwork/fw sync <project>` does
34
+ the same from a clean clone of the kit, pinned to the commit.
35
+ - `formwork/skills/`, and the first skill in it, `humanizer` 3.1.0, pinned to
36
+ one upstream commit with formwork's change to its rule on bold kept in a
37
+ separate file. `formwork roles` places it in `.claude/skills/` on Claude
38
+ Code, and `generated-current` goes red if that copy is edited by hand.
39
+ - `formwork/style.md`: text the agent writes as you, such as an email or a
40
+ comment, goes through `humanizer` first. A section on reports for two
41
+ readers.
42
+ - A fourteenth core rule: the human is not the courier.
43
+ - A role's `description`, `model`, `skills` and `color` reach the generated
44
+ Claude Code agent instead of being dropped. Codex and Gemini CLI get the
45
+ description and a note.
46
+
47
+ ### Counts
48
+
49
+ Three guards, thirteen checks, twenty eight roles, forty eight rules, one
50
+ skill, 486 tests.
@@ -38,7 +38,10 @@ These do not ask you. They refuse.
38
38
  | A turn does not end while the aggregate is red | `formwork/guard/quality-gate` |
39
39
  | The standing brief is not older than the newest decision | `formwork/check/checks/standing-current` |
40
40
  | Work marked finished left a report behind | `formwork/check/checks/work-paired` |
41
+ | Work marked finished carries the human's read-back, dated | `formwork/check/checks/work-paired` |
42
+ | One brief is open at a time, unless you raise the limit | `formwork/check/checks/work-paired` |
41
43
  | Every generated role names the style page | `formwork/check/checks/style-pointed` |
44
+ | A report opens with a part for the human, under 1,000 words, no commands | `formwork/check/checks/report-shape` |
42
45
 
43
46
  > [!NOTE]
44
47
  > **The turn-end gate refuses three times in a session, then stands aside**, so
@@ -57,13 +60,33 @@ formwork check --list what exists
57
60
  instead: `formwork/fw check`, `formwork/fw demo`, `formwork/fw roles`. Run
58
61
  `formwork/fw` on its own to see the list.
59
62
 
63
+ **To bring a project's copy of the kit up to date**, upgrade the command, then
64
+ run this inside the project:
65
+
66
+ ```
67
+ pipx install --force formwork-kit==X.Y.Z
68
+ formwork sync --dry-run see what would change
69
+ formwork sync copy, delete, pin
70
+ ```
71
+
72
+ From a clone of the kit itself, which only the kit's maintainer needs, the
73
+ same thing is `formwork/fw sync <project>`, and it refuses unless the clone is
74
+ clean and committed.
75
+
76
+ It copies every kit file, deletes the ones the kit no longer has, and writes
77
+ the release, or the clone's commit, into the project's SOURCE.txt. It never touches the project's own
78
+ roles, the project pack, nor any path the project lists as its own in
79
+ `.formwork.toml`, under `[bindings]`, as `local = ["formwork/rules/core.md"]`.
80
+ It stops before recording the fingerprints, because that is your decision, and
81
+ prints the two commands to run yourself.
82
+
60
83
  ---
61
84
 
62
85
  ## What is advice
63
86
 
64
- Everything else. **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.1
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">
@@ -268,7 +268,7 @@ The copy is the whole kit, so you can delete `the-kit` afterwards. There is no
268
268
  `init` step here, because copying the folder in **is** the init step.
269
269
 
270
270
  `formwork check` becomes `formwork/fw check`, and the same for `install`,
271
- `setup`, `demo`, `roles`, `record` and `test`. Run `formwork/fw` on its own for
271
+ `setup`, `demo`, `roles`, `record`, `test` and `sync`. Run `formwork/fw` on its own for
272
272
  the list. `where` and `version` belong to the installed command only.
273
273
 
274
274
  ### What each step does
@@ -278,7 +278,8 @@ the list. `where` and `version` belong to the installed command only.
278
278
  | `init` | puts `formwork/` and `FORMWORK.md` into your project |
279
279
  | `install` | wires the guards into your agent, writes your role files. Add `--runtime <name>` when it cannot tell |
280
280
  | `setup` | asks eleven questions once, then writes your style file, your standing brief, and the folders for decisions, briefs and reports |
281
- | `check` | runs all 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 |
282
283
 
283
284
  **What it touches.** It adds `formwork/` and `FORMWORK.md`, writes
284
285
  `.formwork.toml`, writes your agent's settings file keeping anything already
@@ -383,10 +384,11 @@ in your own words, which beats it. Every role points at both.
383
384
  | | | count it yourself |
384
385
  |---|---|---|
385
386
  | **3 guards** | small programs that refuse. Two stop a command, one stops a turn ending | `ls formwork/guard \| grep -v test_` |
386
- | **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` |
387
388
  | **28 roles** | one file each, saying what that job does and where it stops | `ls formwork/roles/*/*.md \| wc -l` |
388
- | **47 rules** | 13 you meet daily, 34 for when you need them | `grep -c '^### ' formwork/rules/*.md` |
389
- | **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` |
390
392
 
391
393
  It is all text files and small programs. You can read every line. Nothing is
392
394
  hidden. Nothing is sent anywhere.
@@ -431,8 +433,8 @@ today:
431
433
 
432
434
  | | |
433
435
  |---|---|
434
- | **Skills** | one word for a common job, instead of a paragraph. Considered, not started |
435
- | **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 |
436
438
  | **Teams** | more than one person on the same standing brief. Today the method says one director at a time, and nobody has tried two |
437
439
  | **Roles invented on the fly** | asked for by somebody who tried the kit. It cuts across the check that stops two roles owning one job, so it stays a question we have not settled |
438
440
 
@@ -467,6 +469,7 @@ better after you have run it once than before.
467
469
  | [`style.md`](formwork/style.md) | how the agents talk to you, and how to change it |
468
470
  | [`round.md`](formwork/round.md) | how to run a round, and when it is worth it |
469
471
  | [`templates/`](formwork/templates/) | brief, predictions, report, decision, round, standing brief |
472
+ | [`skills/`](formwork/skills/) | skills the kit ships, each pinned to an upstream commit |
470
473
  | [`roles/`](formwork/roles/) | the roles, and how to write your own |
471
474
  | [`rules/`](formwork/rules/) | the rules, each saying what it catches |
472
475
 
@@ -486,6 +489,7 @@ better after you have run it once than before.
486
489
  |---|---|
487
490
  | [`docs/`](docs/) | the survey, the design, and what broke |
488
491
  | [`docs/dogfood.md`](docs/dogfood.md) | the kit failing on its own author, written down |
492
+ | [`CHANGELOG.md`](CHANGELOG.md) | what changed in each release |
489
493
  | [`RELEASING.md`](RELEASING.md) | for the maintainer |
490
494
 
491
495
  ---
@@ -30,7 +30,7 @@ own. Projects never had that. Now they do.*
30
30
  $ pipx install formwork-kit
31
31
  $ formwork init && formwork install
32
32
  $ formwork setup && formwork check
33
- GATE: green. 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">
@@ -239,7 +239,7 @@ The copy is the whole kit, so you can delete `the-kit` afterwards. There is no
239
239
  `init` step here, because copying the folder in **is** the init step.
240
240
 
241
241
  `formwork check` becomes `formwork/fw check`, and the same for `install`,
242
- `setup`, `demo`, `roles`, `record` and `test`. Run `formwork/fw` on its own for
242
+ `setup`, `demo`, `roles`, `record`, `test` and `sync`. Run `formwork/fw` on its own for
243
243
  the list. `where` and `version` belong to the installed command only.
244
244
 
245
245
  ### What each step does
@@ -249,7 +249,8 @@ the list. `where` and `version` belong to the installed command only.
249
249
  | `init` | puts `formwork/` and `FORMWORK.md` into your project |
250
250
  | `install` | wires the guards into your agent, writes your role files. Add `--runtime <name>` when it cannot tell |
251
251
  | `setup` | asks eleven questions once, then writes your style file, your standing brief, and the folders for decisions, briefs and reports |
252
- | `check` | runs all 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 |
253
254
 
254
255
  **What it touches.** It adds `formwork/` and `FORMWORK.md`, writes
255
256
  `.formwork.toml`, writes your agent's settings file keeping anything already
@@ -354,10 +355,11 @@ in your own words, which beats it. Every role points at both.
354
355
  | | | count it yourself |
355
356
  |---|---|---|
356
357
  | **3 guards** | small programs that refuse. Two stop a command, one stops a turn ending | `ls formwork/guard \| grep -v test_` |
357
- | **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` |
358
359
  | **28 roles** | one file each, saying what that job does and where it stops | `ls formwork/roles/*/*.md \| wc -l` |
359
- | **47 rules** | 13 you meet daily, 34 for when you need them | `grep -c '^### ' formwork/rules/*.md` |
360
- | **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` |
361
363
 
362
364
  It is all text files and small programs. You can read every line. Nothing is
363
365
  hidden. Nothing is sent anywhere.
@@ -402,8 +404,8 @@ today:
402
404
 
403
405
  | | |
404
406
  |---|---|
405
- | **Skills** | one word for a common job, instead of a paragraph. Considered, not started |
406
- | **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 |
407
409
  | **Teams** | more than one person on the same standing brief. Today the method says one director at a time, and nobody has tried two |
408
410
  | **Roles invented on the fly** | asked for by somebody who tried the kit. It cuts across the check that stops two roles owning one job, so it stays a question we have not settled |
409
411
 
@@ -438,6 +440,7 @@ better after you have run it once than before.
438
440
  | [`style.md`](formwork/style.md) | how the agents talk to you, and how to change it |
439
441
  | [`round.md`](formwork/round.md) | how to run a round, and when it is worth it |
440
442
  | [`templates/`](formwork/templates/) | brief, predictions, report, decision, round, standing brief |
443
+ | [`skills/`](formwork/skills/) | skills the kit ships, each pinned to an upstream commit |
441
444
  | [`roles/`](formwork/roles/) | the roles, and how to write your own |
442
445
  | [`rules/`](formwork/rules/) | the rules, each saying what it catches |
443
446
 
@@ -457,6 +460,7 @@ better after you have run it once than before.
457
460
  |---|---|
458
461
  | [`docs/`](docs/) | the survey, the design, and what broke |
459
462
  | [`docs/dogfood.md`](docs/dogfood.md) | the kit failing on its own author, written down |
463
+ | [`CHANGELOG.md`](CHANGELOG.md) | what changed in each release |
460
464
  | [`RELEASING.md`](RELEASING.md) | for the maintainer |
461
465
 
462
466
  ---