@leeovery/claude-technical-workflows 2.1.34 → 2.1.35
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.
- package/README.md +1 -2
- package/agents/planning-task-author.md +46 -16
- package/agents/review-findings-synthesizer.md +14 -18
- package/agents/review-task-verifier.md +3 -4
- package/package.json +1 -1
- package/skills/begin-implementation/SKILL.md +5 -1
- package/skills/begin-planning/SKILL.md +5 -1
- package/skills/migrate/SKILL.md +2 -1
- package/skills/migrate/scripts/migrate.sh +31 -28
- package/skills/migrate/scripts/migrations/001-discussion-frontmatter.sh +1 -15
- package/skills/migrate/scripts/migrations/002-specification-frontmatter.sh +0 -14
- package/skills/migrate/scripts/migrations/003-planning-frontmatter.sh +0 -14
- package/skills/migrate/scripts/migrations/004-sources-object-format.sh +0 -12
- package/skills/migrate/scripts/migrations/005-plan-external-deps-frontmatter.sh +0 -12
- package/skills/migrate/scripts/migrations/006-directory-restructure.sh +2 -22
- package/skills/migrate/scripts/migrations/007-tasks-subdirectory.sh +1 -17
- package/skills/migrate/scripts/migrations/008-review-directory-structure.sh +0 -10
- package/skills/migrate/scripts/migrations/009-review-per-plan-storage.sh +117 -0
- package/skills/migrate/scripts/migrations/010-gitignore-sessions.sh +67 -0
- package/skills/start-discussion/SKILL.md +1 -1
- package/skills/start-discussion/references/handle-selection.md +1 -1
- package/skills/start-discussion/references/research-analysis.md +3 -3
- package/skills/start-discussion/scripts/discovery.sh +1 -1
- package/skills/start-review/references/display-plans.md +2 -2
- package/skills/start-review/references/invoke-skill.md +20 -26
- package/skills/start-review/references/select-plans.md +1 -1
- package/skills/start-review/scripts/discovery.sh +15 -64
- package/skills/start-specification/SKILL.md +1 -1
- package/skills/start-specification/references/analysis-flow.md +2 -2
- package/skills/start-specification/references/display-analyze.md +1 -1
- package/skills/start-specification/references/display-groupings.md +3 -3
- package/skills/start-specification/references/display-specs-menu.md +1 -1
- package/skills/start-specification/scripts/discovery.sh +1 -1
- package/skills/technical-planning/SKILL.md +4 -3
- package/skills/technical-planning/references/author-tasks.md +119 -35
- package/skills/technical-planning/references/output-formats/tick/about.md +3 -2
- package/skills/technical-planning/references/output-formats/tick/graph.md +2 -0
- package/skills/technical-planning/references/output-formats/tick/reading.md +2 -0
- package/skills/technical-planning/references/plan-construction.md +11 -15
- package/skills/technical-planning/references/review-integrity.md +1 -1
- package/skills/technical-review/SKILL.md +3 -13
- package/skills/technical-review/references/invoke-review-synthesizer.md +3 -3
- package/skills/technical-review/references/invoke-task-verifiers.md +5 -12
- package/skills/technical-review/references/produce-review.md +2 -4
- package/skills/technical-review/references/review-actions-loop.md +14 -22
- package/skills/technical-review/references/template.md +1 -21
- package/agents/review-product-assessor.md +0 -112
- 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.
|