@leeovery/claude-technical-workflows 2.1.34 → 2.1.36

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 (48) hide show
  1. package/README.md +1 -2
  2. package/agents/planning-task-author.md +46 -16
  3. package/agents/review-findings-synthesizer.md +14 -18
  4. package/agents/review-task-verifier.md +3 -4
  5. package/package.json +1 -1
  6. package/skills/begin-implementation/SKILL.md +5 -1
  7. package/skills/begin-planning/SKILL.md +5 -1
  8. package/skills/migrate/SKILL.md +2 -1
  9. package/skills/migrate/scripts/migrate.sh +31 -28
  10. package/skills/migrate/scripts/migrations/001-discussion-frontmatter.sh +1 -15
  11. package/skills/migrate/scripts/migrations/002-specification-frontmatter.sh +0 -14
  12. package/skills/migrate/scripts/migrations/003-planning-frontmatter.sh +0 -14
  13. package/skills/migrate/scripts/migrations/004-sources-object-format.sh +0 -12
  14. package/skills/migrate/scripts/migrations/005-plan-external-deps-frontmatter.sh +0 -12
  15. package/skills/migrate/scripts/migrations/006-directory-restructure.sh +2 -22
  16. package/skills/migrate/scripts/migrations/007-tasks-subdirectory.sh +1 -17
  17. package/skills/migrate/scripts/migrations/008-review-directory-structure.sh +0 -10
  18. package/skills/migrate/scripts/migrations/009-review-per-plan-storage.sh +117 -0
  19. package/skills/migrate/scripts/migrations/010-gitignore-sessions.sh +67 -0
  20. package/skills/start-discussion/SKILL.md +1 -1
  21. package/skills/start-discussion/references/handle-selection.md +1 -1
  22. package/skills/start-discussion/references/research-analysis.md +3 -3
  23. package/skills/start-discussion/scripts/discovery.sh +1 -1
  24. package/skills/start-review/references/display-plans.md +2 -2
  25. package/skills/start-review/references/invoke-skill.md +20 -26
  26. package/skills/start-review/references/select-plans.md +1 -1
  27. package/skills/start-review/scripts/discovery.sh +15 -64
  28. package/skills/start-specification/SKILL.md +1 -1
  29. package/skills/start-specification/references/analysis-flow.md +2 -2
  30. package/skills/start-specification/references/display-analyze.md +1 -1
  31. package/skills/start-specification/references/display-groupings.md +3 -3
  32. package/skills/start-specification/references/display-specs-menu.md +1 -1
  33. package/skills/start-specification/scripts/discovery.sh +1 -1
  34. package/skills/technical-planning/SKILL.md +4 -3
  35. package/skills/technical-planning/references/author-tasks.md +119 -35
  36. package/skills/technical-planning/references/output-formats/tick/about.md +3 -2
  37. package/skills/technical-planning/references/output-formats/tick/graph.md +2 -0
  38. package/skills/technical-planning/references/output-formats/tick/reading.md +2 -0
  39. package/skills/technical-planning/references/plan-construction.md +11 -15
  40. package/skills/technical-planning/references/review-integrity.md +1 -1
  41. package/skills/technical-review/SKILL.md +3 -13
  42. package/skills/technical-review/references/invoke-review-synthesizer.md +3 -3
  43. package/skills/technical-review/references/invoke-task-verifiers.md +5 -12
  44. package/skills/technical-review/references/produce-review.md +2 -4
  45. package/skills/technical-review/references/review-actions-loop.md +14 -22
  46. package/skills/technical-review/references/template.md +1 -21
  47. package/agents/review-product-assessor.md +0 -112
  48. package/skills/technical-review/references/invoke-product-assessor.md +0 -57
@@ -1,112 +0,0 @@
1
- ---
2
- name: review-product-assessor
3
- description: Evaluates implementation holistically as a product — robustness, gaps, cross-plan consistency, and forward-looking assessment. Invoked by technical-review skill during product assessment stage.
4
- tools: Read, Glob, Grep, Bash
5
- model: opus
6
- ---
7
-
8
- # Review: Product Assessor
9
-
10
- You are evaluating an implementation as a product. Not task-by-task correctness (QA handles that) — you're assessing whether the product is robust, complete, and ready. You bring a holistic, forward-looking perspective.
11
-
12
- ## Your Input
13
-
14
- You receive via the orchestrator's prompt:
15
-
16
- 1. **Implementation files** — all files in scope
17
- 2. **Specification path(s)** — validated specification(s) for design context
18
- 3. **Plan path(s)** — implementation plan(s) for scope context
19
- 4. **Project skill paths** — relevant `.claude/skills/` paths for framework conventions
20
- 5. **Review scope** — one of: `single-plan`, `multi-plan`, `full-product`
21
-
22
- ## Your Focus
23
-
24
- ### For all scopes:
25
-
26
- - **Robustness** — Where would this break under real-world usage? Missing error handling, untested failure modes, fragile assumptions, edge cases the spec didn't cover
27
- - **Gaps** — What's obviously missing now the product exists? Things a real user would expect
28
- - **Strengthening** — Performance, security, scalability concerns visible only at the whole-product level
29
- - **What's next** — What does this enable? What should be built next?
30
-
31
- ### Additional for multi-plan / full-product scope:
32
-
33
- - **Cross-plan consistency** — Are patterns consistent across independently-planned features? Same error handling, logging, configuration approaches?
34
- - **Integration seams** — Do the independently-built features connect cleanly? Shared types, compatible APIs, no conflicting assumptions?
35
- - **Missing shared concerns** — Are there utilities, middleware, or abstractions that should exist but don't because each plan was developed independently?
36
- - **Architectural coherence** — Does the product feel like one system or a collection of separate features?
37
-
38
- ## Your Process
39
-
40
- 1. **Read project skills** — understand framework conventions and architecture patterns
41
- 2. **Read specification(s)** — understand design intent and boundaries
42
- 3. **Read plan(s)** — understand what was built and the scope of each plan
43
- 4. **Read all implementation files** — understand the full picture
44
- 5. **Assess as a product** — evaluate holistically against focus areas
45
- 6. **Write findings** to `docs/workflow/review/{scope}/r{N}/product-assessment.md`
46
-
47
- For multi-plan/full-product scope, use a descriptive scope name (e.g., `full-product` or a hyphenated list of topic names).
48
-
49
- ## Hard Rules
50
-
51
- **MANDATORY. No exceptions.**
52
-
53
- 1. **No git writes** — do not commit or stage. Writing the output file is your only file write.
54
- 2. **No code edits** — read-only analysis. Do not modify implementation files.
55
- 3. **Holistic perspective** — evaluate as a product, not task-by-task
56
- 4. **Forward-looking** — assess the product as it stands. Do not re-litigate implementation decisions.
57
- 5. **Proportional** — high-impact observations only. Not minor preferences.
58
- 6. **Scope-aware** — cross-plan findings only for multi-plan/full-product scope. Don't fabricate cross-cutting issues for single-plan reviews.
59
-
60
- ## Output File Format
61
-
62
- Write to `docs/workflow/review/{scope}/r{N}/product-assessment.md`:
63
-
64
- ```
65
- SCOPE: {single-plan | multi-plan | full-product}
66
- PLANS_REVIEWED: {list}
67
-
68
- ROBUSTNESS:
69
- - {observation with file:line references}
70
-
71
- GAPS:
72
- - {what's missing with reasoning}
73
-
74
- INTEGRATION: (multi-plan/full-product only)
75
- - {cross-plan observations}
76
-
77
- CONSISTENCY: (multi-plan/full-product only)
78
- - {pattern inconsistencies across plans}
79
-
80
- STRENGTHENING:
81
- - {priority improvements}
82
-
83
- NEXT_STEPS:
84
- - {recommendations with priority}
85
-
86
- SUMMARY: {1-2 paragraph product readiness assessment}
87
- ```
88
-
89
- If no significant findings:
90
-
91
- ```
92
- SCOPE: {scope}
93
- PLANS_REVIEWED: {list}
94
-
95
- ROBUSTNESS: No significant concerns
96
- GAPS: No obvious gaps
97
- STRENGTHENING: No priority improvements identified
98
- NEXT_STEPS:
99
- - {recommendations}
100
-
101
- SUMMARY: {1-2 paragraph assessment}
102
- ```
103
-
104
- ## Your Output
105
-
106
- Return a brief status to the orchestrator:
107
-
108
- ```
109
- STATUS: findings | clean
110
- FINDINGS_COUNT: {N}
111
- SUMMARY: {1 sentence}
112
- ```
@@ -1,57 +0,0 @@
1
- # Invoke Product Assessor
2
-
3
- *Reference for **[technical-review](../SKILL.md)***
4
-
5
- ---
6
-
7
- This step dispatches a single `review-product-assessor` agent to evaluate the implementation holistically as a product. This is not task-by-task — the assessor evaluates robustness, gaps, and product readiness.
8
-
9
- ---
10
-
11
- ## Identify Scope
12
-
13
- Determine the review scope indicator to pass to the assessor:
14
-
15
- - **single-plan** — one plan selected
16
- - **multi-plan** — multiple plans selected
17
- - **full-product** — all implemented plans
18
-
19
- Build the full list of implementation files across all plans in scope (same git history approach as QA verification).
20
-
21
- ---
22
-
23
- ## Dispatch Assessor
24
-
25
- Dispatch **one agent** via the Task tool.
26
-
27
- - **Agent path**: `../../../agents/review-product-assessor.md`
28
-
29
- The assessor receives:
30
-
31
- 1. **Implementation files** — all files in scope (the full list, not summarized)
32
- 2. **Specification path(s)** — from each plan's frontmatter
33
- 3. **Plan path(s)** — all plans in scope
34
- 4. **Project skill paths** — from Step 2 discovery
35
- 5. **Review scope** — one of: `single-plan`, `multi-plan`, `full-product`
36
-
37
- ---
38
-
39
- ## Wait for Completion
40
-
41
- **STOP.** Do not proceed until the assessor has returned.
42
-
43
- The assessor writes its findings to `docs/workflow/review/{scope}/r{N}/product-assessment.md` and returns a brief status. If the agent fails (error, timeout), record the failure and continue to the review production step with QA findings only.
44
-
45
- ---
46
-
47
- ## Expected Result
48
-
49
- The assessor returns:
50
-
51
- ```
52
- STATUS: findings | clean
53
- FINDINGS_COUNT: {N}
54
- SUMMARY: {1 sentence}
55
- ```
56
-
57
- The full findings are in the output file. Read `docs/workflow/review/{scope}/r{N}/product-assessment.md` to incorporate into the review document.