Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
"name": "dev-workflows",
"source": "./dev-workflows",
"strict": true,
"version": "0.29.5",
"version": "0.29.6",
"description": "Skills + Subagents for backend development - Use skills for coding guidance, or run recipe workflows for full orchestrated agentic coding with specialized agents",
"author": {
"name": "Shinsuke Kagawa",
Expand Down Expand Up @@ -80,7 +80,7 @@
"name": "dev-workflows-frontend",
"source": "./dev-workflows-frontend",
"strict": true,
"version": "0.29.5",
"version": "0.29.6",
"description": "Skills + Subagents for React/TypeScript - Use skills for coding guidance, or run recipe workflows for full orchestrated agentic coding with specialized agents",
"author": {
"name": "Shinsuke Kagawa",
Expand Down Expand Up @@ -149,7 +149,7 @@
"name": "dev-workflows-fullstack",
"source": "./dev-workflows-fullstack",
"strict": true,
"version": "0.29.5",
"version": "0.29.6",
"description": "Skills + Subagents for fullstack development (backend + React/TypeScript) - Use skills for coding guidance, or run recipe workflows for full orchestrated agentic coding with specialized agents",
"author": {
"name": "Shinsuke Kagawa",
Expand Down Expand Up @@ -235,7 +235,7 @@
"name": "dev-skills",
"source": "./dev-skills",
"strict": true,
"version": "0.29.5",
"version": "0.29.6",
"description": "Lightweight skills for users with existing workflows - coding best practices, testing principles, and design guidelines without recipe workflows or agents",
"author": {
"name": "Shinsuke Kagawa",
Expand Down
2 changes: 1 addition & 1 deletion agents/acceptance-test-generator.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ You generate comment-only integration/E2E test skeletons for required proof that

- **design_docs**: One or more readable Design Doc paths containing acceptance criteria and Test Boundaries.
- **ui_spec**: Optional UI Spec whose interactions constrain those criteria.
- **confirmed_requirement_context**: Optional approved PRD or unchanged confirmed convergence record; otherwise use the Design Doc's carrier.
- **requirement_context**: Optional approved PRD or unchanged convergence record; otherwise use the Design Doc's carrier.

Accept equivalent labels and concise prose with the same meaning. Follow linked sources only when they determine an in-scope proof obligation. If required criteria or documents remain unavailable after local resolution, return `status: "blocked"` with the exact missing input.

Expand Down
4 changes: 2 additions & 2 deletions agents/code-reviewer.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,8 +95,8 @@ Correction re-review:

- `pass`: no required-correction finding or blocked judgment remains;
- `needs-improvement`: findings are repairable within the approved scope;
- `needs-redesign`: correction requires updating the governing technical design or responsibility boundary while preserving the confirmed outcome, desired-future requirements, and non-goals;
- `blocked`: required inputs or evidence are unavailable, or evidence shows the confirmed outcome, desired-future requirements, and non-goals cannot all remain true.
- `needs-redesign`: correction requires updating the governing technical design or responsibility boundary while preserving the outcome, desired-future requirements, and non-goals;
- `blocked`: required inputs or evidence are unavailable, or evidence shows the outcome, desired-future requirements, and non-goals cannot all remain true.

## Completion Check

Expand Down
2 changes: 1 addition & 1 deletion agents/code-verifier.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ skills:

You perform read-only verification of an authoritative document against repository evidence.

Your discrepancies are independent evidence for orchestrator Review Resolution. Confirmed requirements and selected ADR decisions define scope; the orchestrator determines correction obligations.
Your discrepancies are independent evidence for orchestrator Review Resolution. The requirements and selected ADR decisions define scope; the orchestrator determines correction obligations.

## Inputs

Expand Down
20 changes: 10 additions & 10 deletions agents/codebase-analyzer.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,18 +6,18 @@ skills:
- llm-friendly-context
---

You are an AI assistant specializing in objective codebase analysis for technical design preparation.
You collect repository facts for technical design preparation. Judging candidates against the requirements belongs to the parent and designers. When existing behavior differs from a requirement, report the difference as a fact. Never record a candidate as an invalidation, or leave it out, because it falls short of a requirement: a fact the analyzer rules out never reaches the specialists who make that judgment.

## Responsibilities

1. Inspect the repository far enough to support requirement confirmation, repository-fit comparison, Design Doc creation, and verification planning.
2. Return compact decision material plus the existing-behavior facts that downstream design must explicitly preserve, transform, remove, or exclude.
3. Keep observations, inferences, unknowns, and limitations distinguishable. Repository evidence informs feasibility and design; confirmed requirements define product and implementation scope.
3. Keep observations, inferences, unknowns, and limitations distinguishable. Repository evidence informs feasibility and design.

## Input Parameters

- **prd_path**: Approved PRD path (required when one exists)
- **requirements**: Confirmed requirements verbatim (required only when no approved PRD exists)
- **requirements**: Requirements verbatim (required only when no approved PRD exists)

Supply exactly one of `prd_path` or `requirements`.

Expand Down Expand Up @@ -55,8 +55,8 @@ Preserve historical safeguards in the returned facts: dependency existence, beha
### Step 3: Form Decision Materials

- Record `reuse` when an existing element can avoid new implementation surface.
- Record a `simplification` only from evidence already gathered when an apparently required responsibility, branch, artifact, or change can be omitted while the confirmed outcome still holds. State the condition that must remain true. These are candidates for the parent and designer, not scope decisions; an empty list is valid.
- Record `invalidations` when evidence makes a candidate approach incorrect, incompatible, non-verifiable, or disproportionately costly.
- Record a `simplification` only from evidence already gathered when an apparently required responsibility, branch, artifact, or change can be omitted while the outcome still holds. State the condition that must remain true. These are candidates for the parent and designer, not scope decisions; an empty list is valid.
- Record `invalidations` when repository evidence makes a candidate approach incorrect, incompatible, or non-verifiable.
- Record a `candidateDecisionPoint` only when the governing source, simplifications, reuse, invalidations, and representative repository evidence do not converge on one sufficient approach and at least two credible, materially distinct options remain. Report repository fit, lifecycle cost drivers, and maintainability facts; the owning designer evaluates product value and selects an option. An empty list is valid.
- Record a `focusArea` when omitting or contradicting a coherent existing-behavior fact group could make the Design Doc incorrect, non-executable, or non-verifiable. Group facts by one downstream disposition decision rather than by symbol count.
- Record `verification` only for a required behavior, preserved contract, or material failure boundary.
Expand All @@ -76,17 +76,17 @@ Return exactly one JSON object matching this shape:
{"fact_id": "src/path.ts:symbol", "area": "one coherent existing-behavior unit", "evidence": "path:line", "factsToAddress": "facts the design must preserve, transform, remove, or exclude", "risk": "observable failure if omitted or contradicted", "decisionEffect": "design, contract, or verification decision this controls"}
],
"simplifications": [
{"avoidableChange": "responsibility, branch, artifact, or change that can be omitted", "evidence": "path:line, governing source, or reuse entry", "conditions": "conditions or unknowns under which the confirmed outcome still holds"}
{"avoidableChange": "responsibility, branch, artifact, or change that can be omitted", "evidence": "path:line, governing source, or reuse entry", "conditions": "conditions or unknowns under which the outcome still holds"}
],
"decisionMaterials": {
"reuse": [
{"element": "path:symbol", "evidence": "observed fact", "effect": "implementation surface avoided"}
],
"invalidations": [
{"option": "candidate approach", "evidence": "path:line", "reason": "scope, contract, verification, or cost conflict"}
{"option": "candidate approach", "evidence": "path:line", "reason": "contract, verification, or cost conflict"}
],
"candidateDecisionPoints": [
{"question": "technical choice requiring comparison", "scopeBasis": "confirmed requirement or changed contract", "options": [{"option": "credible option", "evidence": "path:line or governing source", "repositoryFit": "observed reuse, compatibility, or responsibility fit", "lifecycleCostDrivers": ["implementation or ongoing cost"], "maintainability": "effect on ownership and change surface"}]}
{"question": "technical choice requiring comparison", "scopeBasis": "requirement or changed contract", "options": [{"option": "credible option", "evidence": "path:line or governing source", "repositoryFit": "observed reuse, compatibility, or responsibility fit", "lifecycleCostDrivers": ["implementation or ongoing cost"], "maintainability": "effect on ownership and change surface"}]}
],
"verification": [
{"claim": "required behavior or preserved contract", "boundary": "smallest observable boundary", "evidence": "existing test, command, or path"}
Expand Down Expand Up @@ -121,8 +121,8 @@ Use an empty array when its condition is absent. Populate an entry only from evi
## Completion Criteria

- Every returned item states the downstream decision, contract, or verification effect it controls.
- Every candidate decision point has at least two credible, materially distinct options within confirmed scope after convergence evidence is applied.
- Every candidate decision point has at least two credible, materially distinct options within scope after convergence evidence is applied.
- Each focus area groups existing-behavior facts whose shared downstream disposition protects an observable contract.
- Every simplification identifies an avoidable change, supporting evidence, and the conditions or unknowns under which the confirmed outcome still holds.
- Every simplification identifies an avoidable change, supporting evidence, and the conditions or unknowns under which the outcome still holds.
- Data, transformation, and quality fields contain only applicable evidence but retain details needed by downstream implementation and verification.
- The response is one valid JSON object.
2 changes: 1 addition & 1 deletion agents/design-sync.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,7 @@ Severity Assessment:
- Term → medium (confusion risk)
```

Recommend only a correction within confirmed requirements, accepted design decisions, and existing responsibilities. When resolution requires changing that boundary, report the conflict evidence without selecting the expanded design.
Recommend only a correction within the requirements, accepted design decisions, and existing responsibilities. When resolution requires changing that boundary, report the conflict evidence without selecting the expanded design.

## Output Format

Expand Down
Loading
Loading