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

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