@pennyfarthing/core 10.0.0 → 10.0.2

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 (493) hide show
  1. package/LICENSE +14 -0
  2. package/package.json +22 -12
  3. package/pennyfarthing-dist/agents/README.md +348 -0
  4. package/pennyfarthing-dist/agents/architect.md +180 -0
  5. package/pennyfarthing-dist/agents/dev.md +169 -0
  6. package/pennyfarthing-dist/agents/devops.md +203 -0
  7. package/pennyfarthing-dist/agents/handoff.md +235 -0
  8. package/pennyfarthing-dist/agents/orchestrator.md +182 -0
  9. package/pennyfarthing-dist/agents/pm.md +152 -0
  10. package/pennyfarthing-dist/agents/reviewer-preflight.md +129 -0
  11. package/pennyfarthing-dist/agents/reviewer.md +197 -0
  12. package/pennyfarthing-dist/agents/sm-file-summary.md +79 -0
  13. package/pennyfarthing-dist/agents/sm-finish.md +82 -0
  14. package/pennyfarthing-dist/agents/sm-handoff.md +129 -0
  15. package/pennyfarthing-dist/agents/sm-setup.md +251 -0
  16. package/pennyfarthing-dist/agents/sm.md +298 -0
  17. package/pennyfarthing-dist/agents/tea.md +161 -0
  18. package/pennyfarthing-dist/agents/tech-writer.md +226 -0
  19. package/pennyfarthing-dist/agents/testing-runner.md +184 -0
  20. package/pennyfarthing-dist/agents/ux-designer.md +236 -0
  21. package/pennyfarthing-dist/agents/workflow-status-check.md +96 -0
  22. package/pennyfarthing-dist/commands/architect.md +9 -0
  23. package/pennyfarthing-dist/commands/benchmark-control.md +69 -0
  24. package/pennyfarthing-dist/commands/benchmark.md +485 -0
  25. package/pennyfarthing-dist/commands/brainstorming.md +91 -0
  26. package/pennyfarthing-dist/commands/check.md +156 -0
  27. package/pennyfarthing-dist/commands/chore.md +218 -0
  28. package/pennyfarthing-dist/commands/close-epic.md +139 -0
  29. package/pennyfarthing-dist/commands/continue-session.md +218 -0
  30. package/pennyfarthing-dist/commands/create-branches-from-story.md +358 -0
  31. package/pennyfarthing-dist/commands/create-theme.md +29 -0
  32. package/pennyfarthing-dist/commands/dev.md +9 -0
  33. package/pennyfarthing-dist/commands/devops.md +9 -0
  34. package/pennyfarthing-dist/commands/fix-blocker.md +22 -0
  35. package/pennyfarthing-dist/commands/git-cleanup.md +57 -0
  36. package/pennyfarthing-dist/commands/health-check.md +143 -0
  37. package/pennyfarthing-dist/commands/help.md +264 -0
  38. package/pennyfarthing-dist/commands/job-fair.md +102 -0
  39. package/pennyfarthing-dist/commands/list-themes.md +21 -0
  40. package/pennyfarthing-dist/commands/new-work.md +23 -0
  41. package/pennyfarthing-dist/commands/orchestrator.md +9 -0
  42. package/pennyfarthing-dist/commands/parallel-work.md +73 -0
  43. package/pennyfarthing-dist/commands/party-mode.md +77 -0
  44. package/pennyfarthing-dist/commands/patch.md +210 -0
  45. package/pennyfarthing-dist/commands/permissions.md +193 -0
  46. package/pennyfarthing-dist/commands/pm.md +9 -0
  47. package/pennyfarthing-dist/commands/prime.md +136 -0
  48. package/pennyfarthing-dist/commands/release.md +74 -0
  49. package/pennyfarthing-dist/commands/repo-status.md +49 -0
  50. package/pennyfarthing-dist/commands/retro.md +200 -0
  51. package/pennyfarthing-dist/commands/reviewer.md +9 -0
  52. package/pennyfarthing-dist/commands/run-ci.md +116 -0
  53. package/pennyfarthing-dist/commands/set-theme.md +56 -0
  54. package/pennyfarthing-dist/commands/setup.md +65 -0
  55. package/pennyfarthing-dist/commands/show-theme.md +21 -0
  56. package/pennyfarthing-dist/commands/sm.md +9 -0
  57. package/pennyfarthing-dist/commands/solo.md +447 -0
  58. package/pennyfarthing-dist/commands/sprint-planning.md +109 -0
  59. package/pennyfarthing-dist/commands/sprint.md +142 -0
  60. package/pennyfarthing-dist/commands/standalone.md +194 -0
  61. package/pennyfarthing-dist/commands/start-epic.md +168 -0
  62. package/pennyfarthing-dist/commands/sync-epic-to-jira.md +184 -0
  63. package/pennyfarthing-dist/commands/sync-work-with-sprint.md +373 -0
  64. package/pennyfarthing-dist/commands/tea.md +9 -0
  65. package/pennyfarthing-dist/commands/tech-writer.md +9 -0
  66. package/pennyfarthing-dist/commands/theme-maker.md +676 -0
  67. package/pennyfarthing-dist/commands/update-domain-docs.md +83 -0
  68. package/pennyfarthing-dist/commands/ux-designer.md +9 -0
  69. package/pennyfarthing-dist/commands/work.md +25 -0
  70. package/pennyfarthing-dist/commands/workflow.md +21 -0
  71. package/pennyfarthing-dist/guides/agent-behavior.md +92 -0
  72. package/pennyfarthing-dist/guides/agent-coordination.md +475 -0
  73. package/pennyfarthing-dist/guides/agent-tag-taxonomy.md +432 -0
  74. package/pennyfarthing-dist/guides/agent-template-strategic.md +148 -0
  75. package/pennyfarthing-dist/guides/agent-template-tactical.md +162 -0
  76. package/pennyfarthing-dist/guides/hooks.md +230 -0
  77. package/pennyfarthing-dist/guides/measurement-framework.md +210 -0
  78. package/pennyfarthing-dist/guides/patterns/approval-gates-pattern.md +766 -0
  79. package/pennyfarthing-dist/guides/patterns/fan-out-fan-in-pattern.md +574 -0
  80. package/pennyfarthing-dist/guides/patterns/helper-delegation-pattern.md +488 -0
  81. package/pennyfarthing-dist/guides/patterns/tdd-flow-pattern.md +402 -0
  82. package/pennyfarthing-dist/guides/permission-protocol.md +188 -0
  83. package/pennyfarthing-dist/guides/persona-loading.md +46 -0
  84. package/pennyfarthing-dist/guides/prompt-patterns.md +338 -0
  85. package/pennyfarthing-dist/guides/scale-levels.md +114 -0
  86. package/pennyfarthing-dist/guides/session-artifacts.md +193 -0
  87. package/pennyfarthing-dist/guides/session-schema.md +346 -0
  88. package/pennyfarthing-dist/guides/skill-schema.md +412 -0
  89. package/pennyfarthing-dist/guides/workflow-schema.md +257 -0
  90. package/pennyfarthing-dist/guides/workflow-step-schema.md +512 -0
  91. package/pennyfarthing-dist/guides/worktree-mode.md +113 -0
  92. package/pennyfarthing-dist/guides/xml-tags.md +627 -0
  93. package/pennyfarthing-dist/output-styles/teaching.md +33 -0
  94. package/pennyfarthing-dist/output-styles/terse.md +20 -0
  95. package/pennyfarthing-dist/output-styles/verbose.md +28 -0
  96. package/pennyfarthing-dist/personas/themes/a-team.yaml +331 -0
  97. package/pennyfarthing-dist/personas/themes/alice-in-wonderland.yaml +324 -0
  98. package/pennyfarthing-dist/personas/themes/battlestar-galactica.yaml +282 -0
  99. package/pennyfarthing-dist/personas/themes/blade-runner.yaml +289 -0
  100. package/pennyfarthing-dist/personas/themes/catch-22.yaml +304 -0
  101. package/pennyfarthing-dist/personas/themes/control.yaml +201 -0
  102. package/pennyfarthing-dist/personas/themes/cowboy-bebop.yaml +315 -0
  103. package/pennyfarthing-dist/personas/themes/discworld.yaml +334 -0
  104. package/pennyfarthing-dist/personas/themes/doctor-who.yaml +284 -0
  105. package/pennyfarthing-dist/personas/themes/dune.yaml +301 -0
  106. package/pennyfarthing-dist/personas/themes/firefly.yaml +320 -0
  107. package/pennyfarthing-dist/personas/themes/game-of-thrones.yaml +284 -0
  108. package/pennyfarthing-dist/personas/themes/harry-potter.yaml +316 -0
  109. package/pennyfarthing-dist/personas/themes/hitchhikers-guide.yaml +323 -0
  110. package/pennyfarthing-dist/personas/themes/lord-of-the-rings.yaml +326 -0
  111. package/pennyfarthing-dist/personas/themes/mad-max.yaml +349 -0
  112. package/pennyfarthing-dist/personas/themes/mash.yaml +329 -0
  113. package/pennyfarthing-dist/personas/themes/princess-bride.yaml +344 -0
  114. package/pennyfarthing-dist/personas/themes/sandman.yaml +282 -0
  115. package/pennyfarthing-dist/personas/themes/star-trek-tng.yaml +358 -0
  116. package/pennyfarthing-dist/personas/themes/star-wars.yaml +297 -0
  117. package/pennyfarthing-dist/personas/themes/the-expanse.yaml +337 -0
  118. package/pennyfarthing-dist/personas/themes/the-matrix.yaml +342 -0
  119. package/pennyfarthing-dist/personas/themes/watchmen.yaml +285 -0
  120. package/pennyfarthing-dist/personas/themes/west-wing.yaml +285 -0
  121. package/pennyfarthing-dist/personas/themes/x-files.yaml +296 -0
  122. package/pennyfarthing-dist/scripts/README.md +87 -0
  123. package/pennyfarthing-dist/scripts/core/README.md +25 -0
  124. package/pennyfarthing-dist/scripts/core/agent-session.sh +390 -0
  125. package/pennyfarthing-dist/scripts/core/check-context.sh +194 -0
  126. package/pennyfarthing-dist/scripts/core/handoff-marker.sh +112 -0
  127. package/pennyfarthing-dist/scripts/core/phase-check-start.sh +90 -0
  128. package/pennyfarthing-dist/scripts/core/prime.sh +30 -0
  129. package/pennyfarthing-dist/scripts/cyclist/is-cyclist.sh +21 -0
  130. package/pennyfarthing-dist/scripts/git/README.md +25 -0
  131. package/pennyfarthing-dist/scripts/git/create-feature-branches.sh +267 -0
  132. package/pennyfarthing-dist/scripts/git/git-status-all.sh +152 -0
  133. package/pennyfarthing-dist/scripts/git/install-git-hooks.sh +79 -0
  134. package/pennyfarthing-dist/scripts/git/release.sh +246 -0
  135. package/pennyfarthing-dist/scripts/git/worktree-manager.sh +497 -0
  136. package/pennyfarthing-dist/scripts/health/drift-detection.sh +156 -0
  137. package/pennyfarthing-dist/scripts/hooks/README.md +32 -0
  138. package/pennyfarthing-dist/scripts/hooks/__pycache__/question_reflector_check.cpython-314.pyc +0 -0
  139. package/pennyfarthing-dist/scripts/hooks/bell-mode-hook.sh +106 -0
  140. package/pennyfarthing-dist/scripts/hooks/context-circuit-breaker.sh +95 -0
  141. package/pennyfarthing-dist/scripts/hooks/context-warning.sh +65 -0
  142. package/pennyfarthing-dist/scripts/hooks/otel-auto-config.sh +35 -0
  143. package/pennyfarthing-dist/scripts/hooks/post-merge.sh +150 -0
  144. package/pennyfarthing-dist/scripts/hooks/pre-commit.sh +190 -0
  145. package/pennyfarthing-dist/scripts/hooks/pre-edit-check.sh +71 -0
  146. package/pennyfarthing-dist/scripts/hooks/pre-push.sh +42 -0
  147. package/pennyfarthing-dist/scripts/hooks/question-reflector-check.sh +20 -0
  148. package/pennyfarthing-dist/scripts/hooks/question_reflector_check.py +499 -0
  149. package/pennyfarthing-dist/scripts/hooks/schema-validation.sh +30 -0
  150. package/pennyfarthing-dist/scripts/hooks/session-start.sh +97 -0
  151. package/pennyfarthing-dist/scripts/hooks/session-stop.sh +65 -0
  152. package/pennyfarthing-dist/scripts/hooks/sprint-yaml-validation.sh +78 -0
  153. package/pennyfarthing-dist/scripts/hooks/welcome-hook.sh +94 -0
  154. package/pennyfarthing-dist/scripts/jira/README.md +36 -0
  155. package/pennyfarthing-dist/scripts/jira/create-jira-epic.sh +95 -0
  156. package/pennyfarthing-dist/scripts/jira/create-jira-story.sh +91 -0
  157. package/pennyfarthing-dist/scripts/jira/jira-claim-story.sh +22 -0
  158. package/pennyfarthing-dist/scripts/jira/jira-lib.sh +464 -0
  159. package/pennyfarthing-dist/scripts/jira/jira-reconcile.sh +260 -0
  160. package/pennyfarthing-dist/scripts/jira/jira-sync-story.sh +18 -0
  161. package/pennyfarthing-dist/scripts/jira/jira-sync.sh +16 -0
  162. package/pennyfarthing-dist/scripts/jira/sync-epic-jira.sh +16 -0
  163. package/pennyfarthing-dist/scripts/jira/sync-epic-to-jira.sh +16 -0
  164. package/pennyfarthing-dist/scripts/lib/README.md +29 -0
  165. package/pennyfarthing-dist/scripts/lib/background-tasks.sh +177 -0
  166. package/pennyfarthing-dist/scripts/lib/checkpoint.sh +136 -0
  167. package/pennyfarthing-dist/scripts/lib/common.sh +212 -0
  168. package/pennyfarthing-dist/scripts/lib/file-lock.sh +269 -0
  169. package/pennyfarthing-dist/scripts/lib/find-root.sh +58 -0
  170. package/pennyfarthing-dist/scripts/lib/logging.sh +186 -0
  171. package/pennyfarthing-dist/scripts/lib/retry.sh +76 -0
  172. package/pennyfarthing-dist/scripts/maintenance/migrate-theme-schema.mjs +102 -0
  173. package/pennyfarthing-dist/scripts/maintenance/sidecar-health.sh +91 -0
  174. package/pennyfarthing-dist/scripts/misc/README.md +44 -0
  175. package/pennyfarthing-dist/scripts/misc/add-short-names.sh +13 -0
  176. package/pennyfarthing-dist/scripts/misc/add_short_names.py +226 -0
  177. package/pennyfarthing-dist/scripts/misc/backlog.sh +77 -0
  178. package/pennyfarthing-dist/scripts/misc/check-status.sh +247 -0
  179. package/pennyfarthing-dist/scripts/misc/find-related-work.sh +231 -0
  180. package/pennyfarthing-dist/scripts/misc/generate-skill-docs.sh +107 -0
  181. package/pennyfarthing-dist/scripts/misc/log-skill-usage.sh +74 -0
  182. package/pennyfarthing-dist/scripts/misc/migrate-bmad-workflow.sh +10 -0
  183. package/pennyfarthing-dist/scripts/misc/migrate_bmad_workflow.py +319 -0
  184. package/pennyfarthing-dist/scripts/misc/repo-scan.sh +141 -0
  185. package/pennyfarthing-dist/scripts/misc/repo-utils.sh +778 -0
  186. package/pennyfarthing-dist/scripts/misc/run-ci.sh +212 -0
  187. package/pennyfarthing-dist/scripts/misc/run-timestamp.sh +7 -0
  188. package/pennyfarthing-dist/scripts/misc/session-cleanup.sh +319 -0
  189. package/pennyfarthing-dist/scripts/misc/skill-usage-report.sh +193 -0
  190. package/pennyfarthing-dist/scripts/misc/statusline.sh +257 -0
  191. package/pennyfarthing-dist/scripts/misc/uninstall.sh +275 -0
  192. package/pennyfarthing-dist/scripts/misc/validate-subagent-frontmatter.sh +160 -0
  193. package/pennyfarthing-dist/scripts/portraits/generate-portraits.py +417 -0
  194. package/pennyfarthing-dist/scripts/portraits/generate-portraits.sh +54 -0
  195. package/pennyfarthing-dist/scripts/sprint/README.md +29 -0
  196. package/pennyfarthing-dist/scripts/sprint/archive-story.sh +133 -0
  197. package/pennyfarthing-dist/scripts/sprint/available-stories.sh +91 -0
  198. package/pennyfarthing-dist/scripts/sprint/check-story.sh +158 -0
  199. package/pennyfarthing-dist/scripts/sprint/get-epic-field.sh +52 -0
  200. package/pennyfarthing-dist/scripts/sprint/get-story-field.sh +63 -0
  201. package/pennyfarthing-dist/scripts/sprint/list-future.sh +145 -0
  202. package/pennyfarthing-dist/scripts/sprint/new-sprint.sh +110 -0
  203. package/pennyfarthing-dist/scripts/sprint/promote-epic.sh +148 -0
  204. package/pennyfarthing-dist/scripts/sprint/sprint-common.sh +415 -0
  205. package/pennyfarthing-dist/scripts/sprint/sprint-info.sh +33 -0
  206. package/pennyfarthing-dist/scripts/sprint/sprint-metrics.sh +230 -0
  207. package/pennyfarthing-dist/scripts/sprint/sprint-status.sh +134 -0
  208. package/pennyfarthing-dist/scripts/sprint/validate-sprint-yaml.sh +139 -0
  209. package/pennyfarthing-dist/scripts/story/README.md +23 -0
  210. package/pennyfarthing-dist/scripts/story/create-story.sh +19 -0
  211. package/pennyfarthing-dist/scripts/story/size-story.sh +18 -0
  212. package/pennyfarthing-dist/scripts/story/story-template.sh +18 -0
  213. package/pennyfarthing-dist/scripts/test/README.md +23 -0
  214. package/pennyfarthing-dist/scripts/test/ensure-swebench-data.sh +59 -0
  215. package/pennyfarthing-dist/scripts/test/ground-truth-judge.py +220 -0
  216. package/pennyfarthing-dist/scripts/test/swebench-judge.py +374 -0
  217. package/pennyfarthing-dist/scripts/test/test-cache.sh +165 -0
  218. package/pennyfarthing-dist/scripts/test/test-setup.sh +337 -0
  219. package/pennyfarthing-dist/scripts/tests/check.test.sh +582 -0
  220. package/pennyfarthing-dist/scripts/tests/dev-story-workflow-import.test.sh +515 -0
  221. package/pennyfarthing-dist/scripts/tests/epics-and-stories-workflow-import.test.sh +599 -0
  222. package/pennyfarthing-dist/scripts/tests/handoff-phase-update.test.sh +332 -0
  223. package/pennyfarthing-dist/scripts/tests/implementation-readiness-workflow-import.test.sh +573 -0
  224. package/pennyfarthing-dist/scripts/tests/migrate-bmad-workflow.test.sh +859 -0
  225. package/pennyfarthing-dist/scripts/tests/prd-workflow-import.test.sh +662 -0
  226. package/pennyfarthing-dist/scripts/tests/project-context-workflow-import.test.sh +589 -0
  227. package/pennyfarthing-dist/scripts/tests/test-character-voice.sh +106 -0
  228. package/pennyfarthing-dist/scripts/tests/test-drift-detection.sh +597 -0
  229. package/pennyfarthing-dist/scripts/tests/test-post-merge-hook.sh +514 -0
  230. package/pennyfarthing-dist/scripts/tests/test-session-checkpoint.sh +517 -0
  231. package/pennyfarthing-dist/scripts/tests/test-solo-command.sh +331 -0
  232. package/pennyfarthing-dist/scripts/tests/ux-design-workflow-import.test.sh +647 -0
  233. package/pennyfarthing-dist/scripts/theme/README.md +22 -0
  234. package/pennyfarthing-dist/scripts/theme/compute-theme-tiers.sh +13 -0
  235. package/pennyfarthing-dist/scripts/theme/compute_theme_tiers.py +402 -0
  236. package/pennyfarthing-dist/scripts/theme/list-themes.sh +30 -0
  237. package/pennyfarthing-dist/scripts/theme/update-theme-tiers.sh +97 -0
  238. package/pennyfarthing-dist/scripts/validation/validate-agent-schema.sh +576 -0
  239. package/pennyfarthing-dist/scripts/workflow/README.md +28 -0
  240. package/pennyfarthing-dist/scripts/workflow/check.py +502 -0
  241. package/pennyfarthing-dist/scripts/workflow/check.sh +24 -0
  242. package/pennyfarthing-dist/scripts/workflow/complete-step.py +304 -0
  243. package/pennyfarthing-dist/scripts/workflow/finish-story.sh +154 -0
  244. package/pennyfarthing-dist/scripts/workflow/fix-session-phase.sh +222 -0
  245. package/pennyfarthing-dist/scripts/workflow/get-workflow-type.py +61 -0
  246. package/pennyfarthing-dist/scripts/workflow/get-workflow-type.sh +13 -0
  247. package/pennyfarthing-dist/scripts/workflow/list-workflows.sh +124 -0
  248. package/pennyfarthing-dist/scripts/workflow/phase-owner.sh +34 -0
  249. package/pennyfarthing-dist/scripts/workflow/resume-workflow.sh +157 -0
  250. package/pennyfarthing-dist/scripts/workflow/show-workflow.sh +132 -0
  251. package/pennyfarthing-dist/scripts/workflow/start-workflow.sh +250 -0
  252. package/pennyfarthing-dist/scripts/workflow/workflow-status.sh +161 -0
  253. package/pennyfarthing-dist/skills/agentic-patterns/SKILL.md +246 -0
  254. package/pennyfarthing-dist/skills/changelog/SKILL.md +385 -0
  255. package/pennyfarthing-dist/skills/code-review/SKILL.md +172 -0
  256. package/pennyfarthing-dist/skills/context-engineering/SKILL.md +277 -0
  257. package/pennyfarthing-dist/skills/cyclist/SKILL.md +88 -0
  258. package/pennyfarthing-dist/skills/dev-patterns/SKILL.md +461 -0
  259. package/pennyfarthing-dist/skills/finalize-run/SKILL.md +261 -0
  260. package/pennyfarthing-dist/skills/jira/SKILL.md +508 -0
  261. package/pennyfarthing-dist/skills/judge/SKILL.md +644 -0
  262. package/pennyfarthing-dist/skills/just/SKILL.md +414 -0
  263. package/pennyfarthing-dist/skills/mermaid/SKILL.md +256 -0
  264. package/pennyfarthing-dist/skills/otel/skill.md +227 -0
  265. package/pennyfarthing-dist/skills/permissions/skill.md +157 -0
  266. package/pennyfarthing-dist/skills/persona-benchmark/SKILL.md +187 -0
  267. package/pennyfarthing-dist/skills/skill-registry.schema.json +107 -0
  268. package/pennyfarthing-dist/skills/skill-registry.yaml +393 -0
  269. package/pennyfarthing-dist/skills/sprint/scripts/archive-story.sh +101 -0
  270. package/pennyfarthing-dist/skills/sprint/scripts/available-stories.sh +97 -0
  271. package/pennyfarthing-dist/skills/sprint/scripts/check-story.sh +164 -0
  272. package/pennyfarthing-dist/skills/sprint/scripts/create-jira-epic.sh +101 -0
  273. package/pennyfarthing-dist/skills/sprint/scripts/new-sprint.sh +116 -0
  274. package/pennyfarthing-dist/skills/sprint/scripts/promote-epic.sh +164 -0
  275. package/pennyfarthing-dist/skills/sprint/scripts/sprint-info.sh +39 -0
  276. package/pennyfarthing-dist/skills/sprint/scripts/sprint-status.sh +147 -0
  277. package/pennyfarthing-dist/skills/sprint/scripts/sync-epic-jira.sh +93 -0
  278. package/pennyfarthing-dist/skills/sprint/skill.md +465 -0
  279. package/pennyfarthing-dist/skills/story/scripts/create-story.sh +159 -0
  280. package/pennyfarthing-dist/skills/story/scripts/size-story.sh +198 -0
  281. package/pennyfarthing-dist/skills/story/scripts/story-template.sh +162 -0
  282. package/pennyfarthing-dist/skills/story/skill.md +219 -0
  283. package/pennyfarthing-dist/skills/systematic-debugging/SKILL.md +446 -0
  284. package/pennyfarthing-dist/skills/testing/SKILL.md +121 -0
  285. package/pennyfarthing-dist/skills/testing/references/troubleshooting.md +124 -0
  286. package/pennyfarthing-dist/skills/theme/skill.md +141 -0
  287. package/pennyfarthing-dist/skills/theme-creation/SKILL.md +178 -0
  288. package/pennyfarthing-dist/skills/workflow/scripts/list-workflows.sh +91 -0
  289. package/pennyfarthing-dist/skills/workflow/scripts/resume-workflow.sh +163 -0
  290. package/pennyfarthing-dist/skills/workflow/scripts/show-workflow.sh +138 -0
  291. package/pennyfarthing-dist/skills/workflow/scripts/start-workflow.sh +273 -0
  292. package/pennyfarthing-dist/skills/workflow/scripts/workflow-status.sh +167 -0
  293. package/pennyfarthing-dist/skills/workflow/skill.md +345 -0
  294. package/pennyfarthing-dist/skills/yq/SKILL.md +272 -0
  295. package/pennyfarthing-dist/templates/LEADERBOARD.schema.yaml +187 -0
  296. package/pennyfarthing-dist/templates/LEADERBOARD.template.md +59 -0
  297. package/pennyfarthing-dist/templates/agent-scopes.yaml.template +276 -0
  298. package/pennyfarthing-dist/templates/pennyfarthing-settings.yaml.template +61 -0
  299. package/pennyfarthing-dist/templates/persona-config.yaml.template +22 -0
  300. package/pennyfarthing-dist/templates/preferences.yaml.template +15 -0
  301. package/pennyfarthing-dist/templates/settings.local.json.template +130 -0
  302. package/pennyfarthing-dist/templates/setup-env.sh.template +18 -0
  303. package/pennyfarthing-dist/templates/shared-context.md.template +70 -0
  304. package/pennyfarthing-dist/templates/sidecar/decisions.md.template +40 -0
  305. package/pennyfarthing-dist/templates/sidecar/gotchas.md.template +37 -0
  306. package/pennyfarthing-dist/templates/sidecar/patterns.md.template +34 -0
  307. package/pennyfarthing-dist/workflows/agent-docs.yaml +70 -0
  308. package/pennyfarthing-dist/workflows/architecture/steps/step-01-initialize.md +113 -0
  309. package/pennyfarthing-dist/workflows/architecture/steps/step-01b-continue.md +105 -0
  310. package/pennyfarthing-dist/workflows/architecture/steps/step-02-context.md +127 -0
  311. package/pennyfarthing-dist/workflows/architecture/steps/step-03-patterns.md +145 -0
  312. package/pennyfarthing-dist/workflows/architecture/steps/step-04-components.md +150 -0
  313. package/pennyfarthing-dist/workflows/architecture/steps/step-05-interfaces.md +145 -0
  314. package/pennyfarthing-dist/workflows/architecture/steps/step-06-risks.md +154 -0
  315. package/pennyfarthing-dist/workflows/architecture/steps/step-07-document.md +172 -0
  316. package/pennyfarthing-dist/workflows/architecture/templates/architecture-decision.md +102 -0
  317. package/pennyfarthing-dist/workflows/architecture.yaml +65 -0
  318. package/pennyfarthing-dist/workflows/bdd.yaml +60 -0
  319. package/pennyfarthing-dist/workflows/brainstorming/brain-methods.csv +62 -0
  320. package/pennyfarthing-dist/workflows/brainstorming/checklist.md +44 -0
  321. package/pennyfarthing-dist/workflows/brainstorming/instructions.md +736 -0
  322. package/pennyfarthing-dist/workflows/brainstorming/workflow.yaml +49 -0
  323. package/pennyfarthing-dist/workflows/code-review/checklist.md +23 -0
  324. package/pennyfarthing-dist/workflows/code-review/instructions.md +234 -0
  325. package/pennyfarthing-dist/workflows/code-review/workflow.yaml +51 -0
  326. package/pennyfarthing-dist/workflows/dev-story/checklist.md +80 -0
  327. package/pennyfarthing-dist/workflows/dev-story/instructions.xml +410 -0
  328. package/pennyfarthing-dist/workflows/dev-story/workflow.yaml +50 -0
  329. package/pennyfarthing-dist/workflows/epics-and-stories/steps/step-01-validate-prerequisites.md +281 -0
  330. package/pennyfarthing-dist/workflows/epics-and-stories/steps/step-02-design-epics.md +256 -0
  331. package/pennyfarthing-dist/workflows/epics-and-stories/steps/step-03-create-stories.md +298 -0
  332. package/pennyfarthing-dist/workflows/epics-and-stories/steps/step-04-final-validation.md +177 -0
  333. package/pennyfarthing-dist/workflows/epics-and-stories/steps/step-05-import-to-future.md +145 -0
  334. package/pennyfarthing-dist/workflows/epics-and-stories/templates/epics-template.md +57 -0
  335. package/pennyfarthing-dist/workflows/epics-and-stories/workflow.yaml +28 -0
  336. package/pennyfarthing-dist/workflows/git-cleanup/steps/step-01-analyze.md +103 -0
  337. package/pennyfarthing-dist/workflows/git-cleanup/steps/step-02-categorize.md +147 -0
  338. package/pennyfarthing-dist/workflows/git-cleanup/steps/step-03-execute.md +215 -0
  339. package/pennyfarthing-dist/workflows/git-cleanup/steps/step-04-verify.md +97 -0
  340. package/pennyfarthing-dist/workflows/git-cleanup/steps/step-05-complete.md +78 -0
  341. package/pennyfarthing-dist/workflows/git-cleanup.yaml +59 -0
  342. package/pennyfarthing-dist/workflows/implementation-readiness/steps/step-01-document-discovery.md +211 -0
  343. package/pennyfarthing-dist/workflows/implementation-readiness/steps/step-02-prd-analysis.md +199 -0
  344. package/pennyfarthing-dist/workflows/implementation-readiness/steps/step-03-epic-coverage-validation.md +202 -0
  345. package/pennyfarthing-dist/workflows/implementation-readiness/steps/step-04-ux-alignment.md +162 -0
  346. package/pennyfarthing-dist/workflows/implementation-readiness/steps/step-05-epic-quality-review.md +280 -0
  347. package/pennyfarthing-dist/workflows/implementation-readiness/steps/step-06-final-assessment.md +158 -0
  348. package/pennyfarthing-dist/workflows/implementation-readiness/templates/readiness-report-template.md +4 -0
  349. package/pennyfarthing-dist/workflows/implementation-readiness/workflow.yaml +40 -0
  350. package/pennyfarthing-dist/workflows/interactive-debug/steps/step-01-connect.md +257 -0
  351. package/pennyfarthing-dist/workflows/interactive-debug/steps/step-02-explore.md +107 -0
  352. package/pennyfarthing-dist/workflows/interactive-debug/steps/step-03-fix.md +127 -0
  353. package/pennyfarthing-dist/workflows/interactive-debug/steps/step-04-commit.md +122 -0
  354. package/pennyfarthing-dist/workflows/interactive-debug/workflow.yaml +51 -0
  355. package/pennyfarthing-dist/workflows/patch.yaml +67 -0
  356. package/pennyfarthing-dist/workflows/prd/data/domain-complexity.csv +13 -0
  357. package/pennyfarthing-dist/workflows/prd/data/prd-purpose.md +197 -0
  358. package/pennyfarthing-dist/workflows/prd/data/project-types.csv +11 -0
  359. package/pennyfarthing-dist/workflows/prd/steps-c/step-01-init.md +197 -0
  360. package/pennyfarthing-dist/workflows/prd/steps-c/step-01b-continue.md +159 -0
  361. package/pennyfarthing-dist/workflows/prd/steps-c/step-02-discovery.md +230 -0
  362. package/pennyfarthing-dist/workflows/prd/steps-c/step-03-success.md +232 -0
  363. package/pennyfarthing-dist/workflows/prd/steps-c/step-04-journeys.md +219 -0
  364. package/pennyfarthing-dist/workflows/prd/steps-c/step-05-domain.md +213 -0
  365. package/pennyfarthing-dist/workflows/prd/steps-c/step-06-innovation.md +232 -0
  366. package/pennyfarthing-dist/workflows/prd/steps-c/step-07-project-type.md +243 -0
  367. package/pennyfarthing-dist/workflows/prd/steps-c/step-08-scoping.md +234 -0
  368. package/pennyfarthing-dist/workflows/prd/steps-c/step-09-functional.md +237 -0
  369. package/pennyfarthing-dist/workflows/prd/steps-c/step-10-nonfunctional.md +248 -0
  370. package/pennyfarthing-dist/workflows/prd/steps-c/step-11-polish.md +223 -0
  371. package/pennyfarthing-dist/workflows/prd/steps-c/step-12-complete.md +186 -0
  372. package/pennyfarthing-dist/workflows/prd/steps-e/step-e-01-discovery.md +253 -0
  373. package/pennyfarthing-dist/workflows/prd/steps-e/step-e-01b-legacy-conversion.md +214 -0
  374. package/pennyfarthing-dist/workflows/prd/steps-e/step-e-02-review.md +255 -0
  375. package/pennyfarthing-dist/workflows/prd/steps-e/step-e-03-edit.md +259 -0
  376. package/pennyfarthing-dist/workflows/prd/steps-e/step-e-04-complete.md +174 -0
  377. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-01-discovery.md +224 -0
  378. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-02-format-detection.md +197 -0
  379. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-02b-parity-check.md +215 -0
  380. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-03-density-validation.md +180 -0
  381. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-04-brief-coverage-validation.md +220 -0
  382. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-05-measurability-validation.md +234 -0
  383. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-06-traceability-validation.md +223 -0
  384. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-07-implementation-leakage-validation.md +211 -0
  385. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-08-domain-compliance-validation.md +249 -0
  386. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-09-project-type-validation.md +269 -0
  387. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-10-smart-validation.md +215 -0
  388. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-11-holistic-quality-validation.md +270 -0
  389. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-12-completeness-validation.md +248 -0
  390. package/pennyfarthing-dist/workflows/prd/steps-v/step-v-13-report-complete.md +238 -0
  391. package/pennyfarthing-dist/workflows/prd/templates/prd-template.md +10 -0
  392. package/pennyfarthing-dist/workflows/prd/workflow.yaml +42 -0
  393. package/pennyfarthing-dist/workflows/product-brief/steps/step-01-init.md +195 -0
  394. package/pennyfarthing-dist/workflows/product-brief/steps/step-01b-continue.md +180 -0
  395. package/pennyfarthing-dist/workflows/product-brief/steps/step-02-vision.md +221 -0
  396. package/pennyfarthing-dist/workflows/product-brief/steps/step-03-users.md +224 -0
  397. package/pennyfarthing-dist/workflows/product-brief/steps/step-04-metrics.md +228 -0
  398. package/pennyfarthing-dist/workflows/product-brief/steps/step-05-scope.md +243 -0
  399. package/pennyfarthing-dist/workflows/product-brief/steps/step-06-complete.md +216 -0
  400. package/pennyfarthing-dist/workflows/product-brief/templates/product-brief.template.md +10 -0
  401. package/pennyfarthing-dist/workflows/product-brief/workflow.yaml +31 -0
  402. package/pennyfarthing-dist/workflows/project-context/project-context-template.md +21 -0
  403. package/pennyfarthing-dist/workflows/project-context/steps/step-01-discover.md +206 -0
  404. package/pennyfarthing-dist/workflows/project-context/steps/step-02-generate.md +349 -0
  405. package/pennyfarthing-dist/workflows/project-context/steps/step-03-complete.md +306 -0
  406. package/pennyfarthing-dist/workflows/project-context/workflow.yaml +27 -0
  407. package/pennyfarthing-dist/workflows/project-setup/steps/step-01-discover.md +157 -0
  408. package/pennyfarthing-dist/workflows/project-setup/steps/step-02-clone-repos.md +217 -0
  409. package/pennyfarthing-dist/workflows/project-setup/steps/step-03-repos-yaml.md +159 -0
  410. package/pennyfarthing-dist/workflows/project-setup/steps/step-04-claude-md.md +186 -0
  411. package/pennyfarthing-dist/workflows/project-setup/steps/step-05-shared-context.md +185 -0
  412. package/pennyfarthing-dist/workflows/project-setup/steps/step-06-task-runner.md +279 -0
  413. package/pennyfarthing-dist/workflows/project-setup/steps/step-07-theme.md +200 -0
  414. package/pennyfarthing-dist/workflows/project-setup/steps/step-08-theme-packs.md +142 -0
  415. package/pennyfarthing-dist/workflows/project-setup/steps/step-09-cyclist.md +245 -0
  416. package/pennyfarthing-dist/workflows/project-setup/steps/step-10-complete.md +204 -0
  417. package/pennyfarthing-dist/workflows/project-setup/workflow.yaml +41 -0
  418. package/pennyfarthing-dist/workflows/quick-dev/steps/step-01-mode-detection.md +177 -0
  419. package/pennyfarthing-dist/workflows/quick-dev/steps/step-02-context-gathering.md +143 -0
  420. package/pennyfarthing-dist/workflows/quick-dev/steps/step-03-execute.md +138 -0
  421. package/pennyfarthing-dist/workflows/quick-dev/steps/step-04-self-check.md +135 -0
  422. package/pennyfarthing-dist/workflows/quick-dev/steps/step-05-adversarial-review.md +129 -0
  423. package/pennyfarthing-dist/workflows/quick-dev/steps/step-06-resolve-findings.md +163 -0
  424. package/pennyfarthing-dist/workflows/quick-dev/workflow.yaml +27 -0
  425. package/pennyfarthing-dist/workflows/quick-spec/steps/step-01-understand.md +201 -0
  426. package/pennyfarthing-dist/workflows/quick-spec/steps/step-02-investigate.md +156 -0
  427. package/pennyfarthing-dist/workflows/quick-spec/steps/step-03-generate.md +140 -0
  428. package/pennyfarthing-dist/workflows/quick-spec/steps/step-04-review.md +203 -0
  429. package/pennyfarthing-dist/workflows/quick-spec/tech-spec-template.md +74 -0
  430. package/pennyfarthing-dist/workflows/quick-spec/workflow.yaml +27 -0
  431. package/pennyfarthing-dist/workflows/release/steps/step-01-preflight.md +105 -0
  432. package/pennyfarthing-dist/workflows/release/steps/step-02-bump.md +95 -0
  433. package/pennyfarthing-dist/workflows/release/steps/step-03-changelog.md +125 -0
  434. package/pennyfarthing-dist/workflows/release/steps/step-04-readme.md +101 -0
  435. package/pennyfarthing-dist/workflows/release/steps/step-05-claude-md.md +102 -0
  436. package/pennyfarthing-dist/workflows/release/steps/step-06-retro.md +59 -0
  437. package/pennyfarthing-dist/workflows/release/steps/step-07-commit.md +109 -0
  438. package/pennyfarthing-dist/workflows/release/steps/step-08-merge.md +65 -0
  439. package/pennyfarthing-dist/workflows/release/steps/step-09-push.md +75 -0
  440. package/pennyfarthing-dist/workflows/release/steps/step-10-publish.md +93 -0
  441. package/pennyfarthing-dist/workflows/release/steps/step-11-finalize.md +71 -0
  442. package/pennyfarthing-dist/workflows/release.yaml +62 -0
  443. package/pennyfarthing-dist/workflows/research/steps-domain/step-01-init.md +159 -0
  444. package/pennyfarthing-dist/workflows/research/steps-domain/step-02-domain-analysis.md +253 -0
  445. package/pennyfarthing-dist/workflows/research/steps-domain/step-03-competitive-landscape.md +263 -0
  446. package/pennyfarthing-dist/workflows/research/steps-domain/step-04-regulatory-focus.md +232 -0
  447. package/pennyfarthing-dist/workflows/research/steps-domain/step-05-technical-trends.md +260 -0
  448. package/pennyfarthing-dist/workflows/research/steps-domain/step-06-research-synthesis.md +477 -0
  449. package/pennyfarthing-dist/workflows/research/steps-market/step-01-init.md +205 -0
  450. package/pennyfarthing-dist/workflows/research/steps-market/step-02-customer-behavior.md +262 -0
  451. package/pennyfarthing-dist/workflows/research/steps-market/step-02-customer-insights.md +227 -0
  452. package/pennyfarthing-dist/workflows/research/steps-market/step-03-customer-pain-points.md +275 -0
  453. package/pennyfarthing-dist/workflows/research/steps-market/step-04-customer-decisions.md +286 -0
  454. package/pennyfarthing-dist/workflows/research/steps-market/step-05-competitive-analysis.md +203 -0
  455. package/pennyfarthing-dist/workflows/research/steps-market/step-06-research-completion.md +510 -0
  456. package/pennyfarthing-dist/workflows/research/steps-technical/step-01-init.md +159 -0
  457. package/pennyfarthing-dist/workflows/research/steps-technical/step-02-technical-overview.md +264 -0
  458. package/pennyfarthing-dist/workflows/research/steps-technical/step-03-integration-patterns.md +274 -0
  459. package/pennyfarthing-dist/workflows/research/steps-technical/step-04-architectural-patterns.md +228 -0
  460. package/pennyfarthing-dist/workflows/research/steps-technical/step-05-implementation-research.md +267 -0
  461. package/pennyfarthing-dist/workflows/research/steps-technical/step-06-research-synthesis.md +522 -0
  462. package/pennyfarthing-dist/workflows/research/templates/research.template.md +29 -0
  463. package/pennyfarthing-dist/workflows/research/workflow.yaml +45 -0
  464. package/pennyfarthing-dist/workflows/retrospective/checklist.md +31 -0
  465. package/pennyfarthing-dist/workflows/retrospective/instructions.md +1443 -0
  466. package/pennyfarthing-dist/workflows/retrospective/workflow.yaml +50 -0
  467. package/pennyfarthing-dist/workflows/sprint-planning/checklist.md +33 -0
  468. package/pennyfarthing-dist/workflows/sprint-planning/sprint-status-template.yaml +55 -0
  469. package/pennyfarthing-dist/workflows/sprint-planning/steps/step-01-parse-epic-files.md +69 -0
  470. package/pennyfarthing-dist/workflows/sprint-planning/steps/step-02-build-sprint-status.md +61 -0
  471. package/pennyfarthing-dist/workflows/sprint-planning/steps/step-03-status-detection.md +80 -0
  472. package/pennyfarthing-dist/workflows/sprint-planning/steps/step-04-generate-status-file.md +90 -0
  473. package/pennyfarthing-dist/workflows/sprint-planning/steps/step-05-validate-and-report.md +78 -0
  474. package/pennyfarthing-dist/workflows/sprint-planning/workflow.yaml +34 -0
  475. package/pennyfarthing-dist/workflows/tdd.yaml +50 -0
  476. package/pennyfarthing-dist/workflows/trivial.yaml +40 -0
  477. package/pennyfarthing-dist/workflows/ux-design/steps/step-01-init.md +141 -0
  478. package/pennyfarthing-dist/workflows/ux-design/steps/step-01b-continue.md +133 -0
  479. package/pennyfarthing-dist/workflows/ux-design/steps/step-02-discovery.md +196 -0
  480. package/pennyfarthing-dist/workflows/ux-design/steps/step-03-core-experience.md +222 -0
  481. package/pennyfarthing-dist/workflows/ux-design/steps/step-04-emotional-response.md +225 -0
  482. package/pennyfarthing-dist/workflows/ux-design/steps/step-05-inspiration.md +240 -0
  483. package/pennyfarthing-dist/workflows/ux-design/steps/step-06-design-system.md +258 -0
  484. package/pennyfarthing-dist/workflows/ux-design/steps/step-07-defining-experience.md +260 -0
  485. package/pennyfarthing-dist/workflows/ux-design/steps/step-08-visual-foundation.md +230 -0
  486. package/pennyfarthing-dist/workflows/ux-design/steps/step-09-design-directions.md +230 -0
  487. package/pennyfarthing-dist/workflows/ux-design/steps/step-10-user-journeys.md +247 -0
  488. package/pennyfarthing-dist/workflows/ux-design/steps/step-11-component-strategy.md +254 -0
  489. package/pennyfarthing-dist/workflows/ux-design/steps/step-12-ux-patterns.md +243 -0
  490. package/pennyfarthing-dist/workflows/ux-design/steps/step-13-responsive-accessibility.md +270 -0
  491. package/pennyfarthing-dist/workflows/ux-design/steps/step-14-complete.md +234 -0
  492. package/pennyfarthing-dist/workflows/ux-design/ux-design-template.md +13 -0
  493. package/pennyfarthing-dist/workflows/ux-design/workflow.yaml +41 -0
@@ -0,0 +1,163 @@
1
+ #!/bin/bash
2
+ # Resume a stepped workflow from last completed step
3
+ # Usage: .pennyfarthing/scripts/workflow/resume-workflow.sh [name]
4
+ #
5
+ # If no name provided, detects from active session
6
+
7
+ set -euo pipefail
8
+
9
+ # PROJECT_ROOT should be set by find-root.sh, but find it if not
10
+ if [[ -z "${PROJECT_ROOT:-}" ]]; then
11
+ d="$PWD"
12
+ while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
13
+ d="$(dirname "$d")"
14
+ done
15
+ PROJECT_ROOT="$d"
16
+ fi
17
+
18
+ WORKFLOWS_DIR="$PROJECT_ROOT/.pennyfarthing/workflows"
19
+ SESSION_DIR="$PROJECT_ROOT/.session"
20
+
21
+ if ! command -v yq &> /dev/null; then
22
+ echo "Error: yq is required but not installed"
23
+ echo "Install with: brew install yq"
24
+ exit 1
25
+ fi
26
+
27
+ WORKFLOW_NAME="${1:-}"
28
+
29
+ # If no name, try to detect from session
30
+ if [[ -z "$WORKFLOW_NAME" ]]; then
31
+ # Look for workflow session files
32
+ SESSION_FILE=$(find "$SESSION_DIR" -maxdepth 1 -name "*-workflow-session.md" 2>/dev/null | head -1)
33
+
34
+ if [[ -z "$SESSION_FILE" ]]; then
35
+ echo "# Resume Stepped Workflow"
36
+ echo ""
37
+ echo "No active workflow session found."
38
+ echo ""
39
+ echo "Use \`/workflow start <name>\` to begin a new workflow."
40
+ exit 1
41
+ fi
42
+
43
+ # Extract workflow name from session
44
+ WORKFLOW_NAME=$(grep -E "^\*\*Workflow:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/\*\*Workflow:\*\* //' | tr -d ' ')
45
+
46
+ if [[ -z "$WORKFLOW_NAME" ]]; then
47
+ # Try extracting from filename
48
+ WORKFLOW_NAME=$(basename "$SESSION_FILE" | sed 's/-workflow-session.md//')
49
+ fi
50
+ else
51
+ SESSION_FILE="$SESSION_DIR/${WORKFLOW_NAME}-workflow-session.md"
52
+ fi
53
+
54
+ if [[ ! -f "$SESSION_FILE" ]]; then
55
+ echo "Error: No session found for workflow '$WORKFLOW_NAME'"
56
+ echo ""
57
+ echo "Use \`/workflow start $WORKFLOW_NAME\` to begin."
58
+ exit 1
59
+ fi
60
+
61
+ # Find workflow file
62
+ WORKFLOW_FILE=""
63
+ if [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml" ]]; then
64
+ WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml"
65
+ elif [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml" ]]; then
66
+ WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml"
67
+ else
68
+ echo "Error: Workflow definition '$WORKFLOW_NAME' not found"
69
+ exit 1
70
+ fi
71
+
72
+ WORKFLOW_DIR=$(dirname "$WORKFLOW_FILE")
73
+
74
+ # Parse session state
75
+ CURRENT_STEP=$(grep -E "^\- \*\*Current Step:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "1")
76
+ MODE=$(grep -E "^\- \*\*Mode:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "create")
77
+ STATUS=$(grep -E "^\- \*\*Status:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "in_progress")
78
+ STEPS_COMPLETED=$(grep -E "^\- \*\*Steps Completed:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "[]")
79
+
80
+ # Check if workflow is complete
81
+ if [[ "$STATUS" == "completed" ]]; then
82
+ echo "# Workflow Complete: $WORKFLOW_NAME"
83
+ echo ""
84
+ echo "This workflow has already been completed."
85
+ echo ""
86
+ echo "To start a new session, delete the session file:"
87
+ echo "\`\`\`bash"
88
+ echo "rm \"$SESSION_FILE\""
89
+ echo "\`\`\`"
90
+ echo ""
91
+ echo "Then run \`/workflow start $WORKFLOW_NAME\`"
92
+ exit 0
93
+ fi
94
+
95
+ # Resolve steps path based on mode
96
+ MODE_PATH=$(yq eval ".workflow.modes.$MODE // \"\"" "$WORKFLOW_FILE")
97
+ if [[ -n "$MODE_PATH" && "$MODE_PATH" != "null" ]]; then
98
+ STEPS_PATH="$MODE_PATH"
99
+ else
100
+ STEPS_PATH=$(yq eval '.workflow.steps.path' "$WORKFLOW_FILE")
101
+ fi
102
+
103
+ # Resolve relative path
104
+ if [[ "$STEPS_PATH" == ./* ]]; then
105
+ STEPS_PATH="$WORKFLOW_DIR/${STEPS_PATH#./}"
106
+ elif [[ "$STEPS_PATH" != /* ]]; then
107
+ STEPS_PATH="$PROJECT_ROOT/$STEPS_PATH"
108
+ fi
109
+
110
+ # Count steps
111
+ STEP_COUNT=$(find "$STEPS_PATH" -maxdepth 1 -name "step-0*.md" -o -name "step-1*.md" 2>/dev/null | wc -l | tr -d ' ')
112
+
113
+ # Find the current step file
114
+ # Handle various naming: step-01.md, step-01-name.md, step-1-name.md
115
+ PADDED_STEP=$(printf "%02d" "$CURRENT_STEP")
116
+ STEP_FILE=$(find "$STEPS_PATH" -maxdepth 1 \( -name "step-${PADDED_STEP}*.md" -o -name "step-${CURRENT_STEP}-*.md" \) 2>/dev/null | sort | head -1)
117
+
118
+ if [[ -z "$STEP_FILE" ]]; then
119
+ echo "Error: Could not find step $CURRENT_STEP file in $STEPS_PATH"
120
+ exit 1
121
+ fi
122
+
123
+ # Update last updated timestamp
124
+ NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
125
+ sed -i '' "s/^\- \*\*Last Updated:\*\*.*/- **Last Updated:** $NOW/" "$SESSION_FILE" 2>/dev/null || true
126
+
127
+ # Calculate completion percentage
128
+ COMPLETED_COUNT=$(echo "$STEPS_COMPLETED" | tr -cd ',' | wc -c | tr -d ' ')
129
+ if [[ "$STEPS_COMPLETED" != "[]" ]]; then
130
+ COMPLETED_COUNT=$((COMPLETED_COUNT + 1))
131
+ fi
132
+ if [[ "$STEP_COUNT" -gt 0 ]]; then
133
+ COMPLETION_PCT=$((COMPLETED_COUNT * 100 / STEP_COUNT))
134
+ else
135
+ COMPLETION_PCT=0
136
+ fi
137
+
138
+ # Output resume info
139
+ echo "# Resuming Workflow: $WORKFLOW_NAME"
140
+ echo ""
141
+ echo "**Mode:** $MODE"
142
+ echo "**Progress:** Step $CURRENT_STEP of $STEP_COUNT ($COMPLETION_PCT% complete)"
143
+ echo "**Steps Completed:** $STEPS_COMPLETED"
144
+ echo "**Session:** $SESSION_FILE"
145
+ echo ""
146
+ echo "---"
147
+ echo ""
148
+ echo "## Step $CURRENT_STEP of $STEP_COUNT"
149
+ echo ""
150
+
151
+ # Output step content (strip frontmatter if present)
152
+ if head -1 "$STEP_FILE" | grep -q "^---$"; then
153
+ awk '/^---$/{if(++c==2){p=1;next}}p' "$STEP_FILE"
154
+ else
155
+ cat "$STEP_FILE"
156
+ fi
157
+
158
+ echo ""
159
+ echo "---"
160
+ echo ""
161
+ echo "**Controls:**"
162
+ echo "- \`C\` - Continue to next step"
163
+ echo "- \`/workflow status\` - Check progress"
@@ -0,0 +1,138 @@
1
+ #!/bin/bash
2
+ # Show workflow details
3
+ # Usage: .pennyfarthing/scripts/workflow/show-workflow.sh [name]
4
+ # or: Invoked with PROJECT_ROOT already set
5
+ #
6
+ # If no name provided, shows current session's workflow
7
+ # If name provided, shows that workflow's details
8
+
9
+ set -euo pipefail
10
+
11
+ # PROJECT_ROOT should be set by find-root.sh, but find it if not
12
+ if [[ -z "${PROJECT_ROOT:-}" ]]; then
13
+ d="$PWD"
14
+ while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
15
+ d="$(dirname "$d")"
16
+ done
17
+ PROJECT_ROOT="$d"
18
+ fi
19
+
20
+ WORKFLOWS_DIR="$PROJECT_ROOT/.pennyfarthing/workflows"
21
+ SESSION_DIR="$PROJECT_ROOT/.session"
22
+
23
+ if ! command -v yq &> /dev/null; then
24
+ echo "Error: yq is required but not installed"
25
+ echo "Install with: brew install yq"
26
+ exit 1
27
+ fi
28
+
29
+ # Get workflow name from argument or session
30
+ WORKFLOW_NAME="${1:-}"
31
+
32
+ if [[ -z "$WORKFLOW_NAME" ]]; then
33
+ # Try to get from current session (exclude archive directory)
34
+ SESSION_FILE=$(find "$SESSION_DIR" -maxdepth 1 -name "*-session.md" 2>/dev/null | head -1)
35
+ if [[ -n "$SESSION_FILE" ]]; then
36
+ # Extract workflow from session file (look for **Workflow:** line)
37
+ WORKFLOW_NAME=$(grep -E "^\*\*Workflow:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' | tr -d ' ' || echo "")
38
+ if [[ -z "$WORKFLOW_NAME" ]]; then
39
+ # Try alternate format (Workflow: value in tracking section)
40
+ WORKFLOW_NAME=$(grep -E "^Workflow:" "$SESSION_FILE" 2>/dev/null | head -1 | cut -d: -f2 | tr -d ' ' || echo "")
41
+ fi
42
+ fi
43
+
44
+ if [[ -z "$WORKFLOW_NAME" ]]; then
45
+ echo "# Current Workflow"
46
+ echo ""
47
+ echo "No active session found. Showing default workflow (tdd)."
48
+ echo ""
49
+ WORKFLOW_NAME="tdd"
50
+ else
51
+ echo "# Current Session Workflow: $WORKFLOW_NAME"
52
+ echo ""
53
+ fi
54
+ else
55
+ echo "# Workflow: $WORKFLOW_NAME"
56
+ echo ""
57
+ fi
58
+
59
+ WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml"
60
+
61
+ if [[ ! -f "$WORKFLOW_FILE" ]]; then
62
+ echo "Error: Workflow '$WORKFLOW_NAME' not found"
63
+ echo ""
64
+ echo "Available workflows:"
65
+ for f in "$WORKFLOWS_DIR"/*.yaml; do
66
+ [[ -f "$f" ]] || continue
67
+ basename "$f" .yaml
68
+ done
69
+ exit 1
70
+ fi
71
+
72
+ # Extract workflow details
73
+ DESC=$(yq eval '.workflow.description' "$WORKFLOW_FILE")
74
+ VERSION=$(yq eval '.workflow.version' "$WORKFLOW_FILE")
75
+
76
+ echo "**Description:** $DESC"
77
+ echo "**Version:** $VERSION"
78
+ echo ""
79
+
80
+ # Show phases as a flow diagram
81
+ echo "## Phase Flow"
82
+ echo ""
83
+ echo -n "\`\`\`"
84
+ echo ""
85
+
86
+ # Build phase flow string
87
+ PHASES=""
88
+ yq eval '.workflow.phases[].name' "$WORKFLOW_FILE" | while read -r phase; do
89
+ if [[ -n "$PHASES" ]]; then
90
+ echo -n " -> "
91
+ fi
92
+ echo -n "$phase"
93
+ PHASES="$phase"
94
+ done
95
+ echo ""
96
+ echo "\`\`\`"
97
+ echo ""
98
+
99
+ # Show phases table
100
+ echo "## Phases"
101
+ echo ""
102
+ echo "| Phase | Agent | Gate |"
103
+ echo "|-------|-------|------|"
104
+
105
+ yq eval '.workflow.phases[] | .name + "|" + .agent + "|" + (.gate.type // "none")' "$WORKFLOW_FILE" | while IFS='|' read -r phase agent gate; do
106
+ echo "| $phase | $agent | $gate |"
107
+ done
108
+
109
+ echo ""
110
+
111
+ # Show triggers
112
+ echo "## Triggers"
113
+ echo ""
114
+
115
+ TYPES=$(yq eval '.workflow.triggers.types // []' "$WORKFLOW_FILE")
116
+ if [[ "$TYPES" != "[]" && "$TYPES" != "null" ]]; then
117
+ echo "**Types:** $(yq eval '.workflow.triggers.types | join(", ")' "$WORKFLOW_FILE")"
118
+ fi
119
+
120
+ POINTS_MIN=$(yq eval '.workflow.triggers.points.min // ""' "$WORKFLOW_FILE")
121
+ POINTS_MAX=$(yq eval '.workflow.triggers.points.max // ""' "$WORKFLOW_FILE")
122
+
123
+ if [[ -n "$POINTS_MIN" && "$POINTS_MIN" != "null" ]]; then
124
+ echo "**Points Min:** $POINTS_MIN"
125
+ fi
126
+ if [[ -n "$POINTS_MAX" && "$POINTS_MAX" != "null" ]]; then
127
+ echo "**Points Max:** $POINTS_MAX"
128
+ fi
129
+
130
+ IS_DEFAULT=$(yq eval '.workflow.triggers.default // false' "$WORKFLOW_FILE")
131
+ if [[ "$IS_DEFAULT" == "true" ]]; then
132
+ echo "**Default:** yes (used when no other workflow matches)"
133
+ fi
134
+
135
+ TAGS=$(yq eval '.workflow.triggers.tags // []' "$WORKFLOW_FILE")
136
+ if [[ "$TAGS" != "[]" && "$TAGS" != "null" ]]; then
137
+ echo "**Tags:** $(yq eval '.workflow.triggers.tags | join(", ")' "$WORKFLOW_FILE")"
138
+ fi
@@ -0,0 +1,273 @@
1
+ #!/bin/bash
2
+ # Start a stepped workflow
3
+ # Usage: .pennyfarthing/scripts/workflow/start-workflow.sh <name> [--mode create|validate|edit]
4
+ #
5
+ # Creates a new workflow session and loads step 1.
6
+ # For tri-modal workflows, --mode selects the step path (default: create)
7
+
8
+ set -euo pipefail
9
+
10
+ # PROJECT_ROOT should be set by find-root.sh, but find it if not
11
+ if [[ -z "${PROJECT_ROOT:-}" ]]; then
12
+ d="$PWD"
13
+ while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
14
+ d="$(dirname "$d")"
15
+ done
16
+ PROJECT_ROOT="$d"
17
+ fi
18
+
19
+ WORKFLOWS_DIR="$PROJECT_ROOT/.pennyfarthing/workflows"
20
+ SESSION_DIR="$PROJECT_ROOT/.session"
21
+
22
+ if ! command -v yq &> /dev/null; then
23
+ echo "Error: yq is required but not installed"
24
+ echo "Install with: brew install yq"
25
+ exit 1
26
+ fi
27
+
28
+ # Parse arguments
29
+ WORKFLOW_NAME=""
30
+ MODE=""
31
+ ARGS=("$@")
32
+
33
+ i=0
34
+ while [[ $i -lt ${#ARGS[@]} ]]; do
35
+ arg="${ARGS[$i]}"
36
+ case "$arg" in
37
+ --mode=*)
38
+ MODE="${arg#--mode=}"
39
+ ;;
40
+ --mode|-m)
41
+ if [[ $((i+1)) -lt ${#ARGS[@]} ]]; then
42
+ ((i++))
43
+ MODE="${ARGS[$i]}"
44
+ else
45
+ echo "Error: --mode requires a value (create, validate, or edit)"
46
+ exit 1
47
+ fi
48
+ ;;
49
+ -*)
50
+ echo "Error: Unknown option: $arg"
51
+ echo "Usage: start-workflow.sh <name> [--mode create|validate|edit]"
52
+ exit 1
53
+ ;;
54
+ *)
55
+ if [[ -z "$WORKFLOW_NAME" ]]; then
56
+ WORKFLOW_NAME="$arg"
57
+ else
58
+ echo "Error: Unexpected argument: $arg"
59
+ exit 1
60
+ fi
61
+ ;;
62
+ esac
63
+ ((i++))
64
+ done
65
+
66
+ if [[ -z "$WORKFLOW_NAME" ]]; then
67
+ echo "# Start Stepped Workflow"
68
+ echo ""
69
+ echo "Usage: /workflow start <name> [--mode create|validate|edit]"
70
+ echo ""
71
+ echo "**Available stepped workflows:**"
72
+ echo ""
73
+ for f in "$WORKFLOWS_DIR"/*.yaml "$WORKFLOWS_DIR"/*/workflow.yaml; do
74
+ [[ -f "$f" ]] || continue
75
+ workflow_type=$(yq eval '.workflow.type // "phased"' "$f")
76
+ if [[ "$workflow_type" == "stepped" ]]; then
77
+ name=$(yq eval '.workflow.name' "$f")
78
+ desc=$(yq eval '.workflow.description' "$f" | head -1 | cut -c1-60)
79
+ echo "- **$name** - $desc"
80
+ fi
81
+ done
82
+ exit 1
83
+ fi
84
+
85
+ # Find workflow file (support both flat and directory structure)
86
+ WORKFLOW_FILE=""
87
+ if [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml" ]]; then
88
+ WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml"
89
+ elif [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml" ]]; then
90
+ WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml"
91
+ else
92
+ echo "Error: Workflow '$WORKFLOW_NAME' not found"
93
+ echo ""
94
+ echo "Looked in:"
95
+ echo " $WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml"
96
+ echo " $WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml"
97
+ exit 1
98
+ fi
99
+
100
+ WORKFLOW_DIR=$(dirname "$WORKFLOW_FILE")
101
+
102
+ # Validate it's a stepped workflow
103
+ WORKFLOW_TYPE=$(yq eval '.workflow.type // "phased"' "$WORKFLOW_FILE")
104
+ if [[ "$WORKFLOW_TYPE" != "stepped" ]]; then
105
+ echo "Error: '$WORKFLOW_NAME' is a phased workflow, not stepped"
106
+ echo "Use TDD workflow commands (/sm, /tea, /dev, /reviewer) for phased workflows"
107
+ exit 1
108
+ fi
109
+
110
+ # Validate mode if provided
111
+ if [[ -n "$MODE" ]]; then
112
+ case "$MODE" in
113
+ create|validate|edit)
114
+ ;;
115
+ *)
116
+ echo "Error: Invalid mode '$MODE'. Must be one of: create, validate, edit"
117
+ exit 1
118
+ ;;
119
+ esac
120
+ fi
121
+
122
+ # Get workflow info
123
+ WORKFLOW_DESC=$(yq eval '.workflow.description' "$WORKFLOW_FILE")
124
+ WORKFLOW_AGENT=$(yq eval '.workflow.agent // "pm"' "$WORKFLOW_FILE")
125
+
126
+ # Resolve steps path based on mode
127
+ if [[ -n "$MODE" ]]; then
128
+ MODE_PATH=$(yq eval ".workflow.modes.$MODE // \"\"" "$WORKFLOW_FILE")
129
+ if [[ -z "$MODE_PATH" || "$MODE_PATH" == "null" ]]; then
130
+ AVAILABLE_MODES=$(yq eval '.workflow.modes | keys | .[]' "$WORKFLOW_FILE" 2>/dev/null | grep -v default | tr '\n' ', ' | sed 's/,$//')
131
+ echo "Error: Mode '$MODE' not available for workflow '$WORKFLOW_NAME'"
132
+ echo "Available modes: $AVAILABLE_MODES"
133
+ exit 1
134
+ fi
135
+ STEPS_PATH="$MODE_PATH"
136
+ else
137
+ # Use default mode or steps.path
138
+ DEFAULT_MODE=$(yq eval '.workflow.modes.default // ""' "$WORKFLOW_FILE")
139
+ if [[ -n "$DEFAULT_MODE" && "$DEFAULT_MODE" != "null" ]]; then
140
+ MODE_PATH=$(yq eval ".workflow.modes.$DEFAULT_MODE // \"\"" "$WORKFLOW_FILE")
141
+ if [[ -n "$MODE_PATH" && "$MODE_PATH" != "null" ]]; then
142
+ STEPS_PATH="$MODE_PATH"
143
+ MODE="$DEFAULT_MODE"
144
+ fi
145
+ fi
146
+
147
+ if [[ -z "${STEPS_PATH:-}" ]]; then
148
+ STEPS_PATH=$(yq eval '.workflow.steps.path' "$WORKFLOW_FILE")
149
+ MODE="${MODE:-create}"
150
+ fi
151
+ fi
152
+
153
+ # Resolve relative path
154
+ if [[ "$STEPS_PATH" == ./* ]]; then
155
+ STEPS_PATH="$WORKFLOW_DIR/${STEPS_PATH#./}"
156
+ elif [[ "$STEPS_PATH" != /* ]]; then
157
+ STEPS_PATH="$PROJECT_ROOT/$STEPS_PATH"
158
+ fi
159
+
160
+ # Count steps
161
+ STEPS_PATTERN=$(yq eval '.workflow.steps.pattern // "step-*.md"' "$WORKFLOW_FILE")
162
+ STEP_COUNT=$(find "$STEPS_PATH" -maxdepth 1 -name "step-0*.md" -o -name "step-1*.md" 2>/dev/null | wc -l | tr -d ' ')
163
+
164
+ if [[ "$STEP_COUNT" -eq 0 ]]; then
165
+ echo "Error: No step files found in $STEPS_PATH"
166
+ exit 1
167
+ fi
168
+
169
+ # Create session directory
170
+ mkdir -p "$SESSION_DIR"
171
+
172
+ # Generate session filename
173
+ SESSION_FILE="$SESSION_DIR/${WORKFLOW_NAME}-workflow-session.md"
174
+
175
+ # Check for existing session
176
+ if [[ -f "$SESSION_FILE" ]]; then
177
+ echo "**Warning:** Existing session found"
178
+ echo ""
179
+ echo "Session: $SESSION_FILE"
180
+ echo ""
181
+ echo "Options:"
182
+ echo "1. Use \`/workflow resume $WORKFLOW_NAME\` to continue"
183
+ echo "2. Delete the session file to start fresh"
184
+ echo ""
185
+ echo "To start fresh, run:"
186
+ echo "\`\`\`bash"
187
+ echo "rm \"$SESSION_FILE\""
188
+ echo "\`\`\`"
189
+ exit 0
190
+ fi
191
+
192
+ # Create initial session file
193
+ NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
194
+ cat > "$SESSION_FILE" << EOF
195
+ # Workflow Session: $WORKFLOW_NAME
196
+
197
+ **Workflow:** $WORKFLOW_NAME
198
+ **Type:** stepped
199
+ **Agent:** $WORKFLOW_AGENT
200
+ **Started:** $NOW
201
+
202
+ ## Workflow State
203
+ - **Workflow Name:** $WORKFLOW_NAME
204
+ - **Type:** stepped
205
+ - **Mode:** $MODE
206
+ - **Started:** $NOW
207
+ - **Last Updated:** $NOW
208
+ - **Current Step:** 1
209
+ - **Steps Completed:** []
210
+ - **Status:** in_progress
211
+ - **Notes:** Session created via /workflow start
212
+
213
+ ## Progress
214
+ - Total Steps: $STEP_COUNT
215
+ - Completion: 0%
216
+
217
+ ---
218
+
219
+ EOF
220
+
221
+ # Find step 1 file (handle various naming patterns)
222
+ STEP_FILE=$(find "$STEPS_PATH" -maxdepth 1 \( -name "step-01*.md" -o -name "step-1-*.md" \) 2>/dev/null | sort | head -1)
223
+
224
+ if [[ -z "$STEP_FILE" ]]; then
225
+ echo "Error: Could not find step 1 file in $STEPS_PATH"
226
+ exit 1
227
+ fi
228
+
229
+ # Output workflow start info
230
+ echo "# Starting Workflow: $WORKFLOW_NAME"
231
+ echo ""
232
+ echo "**Description:** $WORKFLOW_DESC"
233
+ echo "**Mode:** $MODE"
234
+ echo "**Steps:** $STEP_COUNT"
235
+ echo "**Agent:** $WORKFLOW_AGENT"
236
+ echo "**Session:** $SESSION_FILE"
237
+ echo ""
238
+
239
+ # Check if auto-handoff is enabled (turbo mode)
240
+ CONFIG_FILE="$PROJECT_ROOT/.pennyfarthing/config.local.yaml"
241
+ HANDOFF_MODE="manual"
242
+ if [[ -f "$CONFIG_FILE" ]]; then
243
+ HANDOFF_MODE=$(yq eval '.workflow.handoff_mode // "manual"' "$CONFIG_FILE")
244
+ fi
245
+
246
+ # Emit Reflector directive - auto-invoke if in turbo mode, else show button
247
+ if [[ "$HANDOFF_MODE" == "auto" ]]; then
248
+ echo "**Auto-handoff enabled.** Invoking /$WORKFLOW_AGENT agent..."
249
+ echo ""
250
+ echo "<!-- CYCLIST:INVOKE:/$WORKFLOW_AGENT -->"
251
+ else
252
+ echo "<!-- CYCLIST:HANDOFF:/$WORKFLOW_AGENT -->"
253
+ fi
254
+ echo ""
255
+ echo "---"
256
+ echo ""
257
+ echo "## Step 1 of $STEP_COUNT"
258
+ echo ""
259
+
260
+ # Output step content (strip frontmatter if present)
261
+ if head -1 "$STEP_FILE" | grep -q "^---$"; then
262
+ awk '/^---$/{if(++c==2){p=1;next}}p' "$STEP_FILE"
263
+ else
264
+ cat "$STEP_FILE"
265
+ fi
266
+
267
+ echo ""
268
+ echo "---"
269
+ echo ""
270
+ echo "**Controls:**"
271
+ echo "- \`C\` - Continue to next step"
272
+ echo "- \`/workflow status\` - Check progress"
273
+ echo "- \`/workflow resume\` - Resume after break"