@manhd_d/ai-harness 0.7.0 → 0.9.0

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 (137) hide show
  1. package/CHANGELOG.md +57 -0
  2. package/CONTRIBUTING.md +4 -0
  3. package/README.md +19 -57
  4. package/adapters/java-spring/adapter.yaml +3 -2
  5. package/adapters/java-spring/checks/verification.yaml +12 -0
  6. package/adapters/java-spring/evals/cases.json +10 -0
  7. package/adapters/java-spring/rules/conventions.md +39 -0
  8. package/adapters/java-spring/rules.md +2 -1
  9. package/adapters/kubernetes/adapter.yaml +1 -1
  10. package/adapters/kubernetes/rules.md +3 -0
  11. package/adapters/react-native/adapter.yaml +6 -3
  12. package/adapters/react-native/checks/verification.yaml +36 -0
  13. package/adapters/react-native/evals/cases.json +30 -0
  14. package/adapters/react-native/rules/conventions.md +34 -0
  15. package/adapters/react-native/rules.md +5 -1
  16. package/adapters/react-native/skills/harness-react-native-behavior-testing/SKILL.md +48 -0
  17. package/adapters/react-native/skills/harness-react-native-screen-delivery/SKILL.md +53 -0
  18. package/adapters/react-nextjs/adapter.yaml +6 -3
  19. package/adapters/react-nextjs/checks/verification.yaml +36 -0
  20. package/adapters/react-nextjs/evals/cases.json +30 -0
  21. package/adapters/react-nextjs/rules/conventions.md +37 -0
  22. package/adapters/react-nextjs/rules.md +5 -1
  23. package/adapters/react-nextjs/skills/harness-react-nextjs-behavior-testing/SKILL.md +48 -0
  24. package/adapters/react-nextjs/skills/harness-react-nextjs-feature-delivery/SKILL.md +55 -0
  25. package/capabilities/architecture/README.md +11 -0
  26. package/capabilities/architecture/agents/architecture-reviewer.md +16 -0
  27. package/capabilities/architecture/agents/solution-architect.md +16 -0
  28. package/capabilities/architecture/capability.json +35 -0
  29. package/capabilities/architecture/checks/verification.json +29 -0
  30. package/capabilities/architecture/evals/cases.json +35 -0
  31. package/capabilities/architecture/skills/harness-architecture-change-impact/SKILL.md +43 -0
  32. package/capabilities/architecture/skills/harness-architecture-decision-records/SKILL.md +43 -0
  33. package/capabilities/architecture/skills/harness-architecture-project-context/SKILL.md +43 -0
  34. package/capabilities/architecture/skills/harness-architecture-quality-attributes/SKILL.md +43 -0
  35. package/capabilities/architecture/skills/harness-architecture-review/SKILL.md +43 -0
  36. package/capabilities/architecture/skills/harness-architecture-solution-design/SKILL.md +44 -0
  37. package/capabilities/architecture/templates/adr.md +29 -0
  38. package/capabilities/architecture/templates/nfr.md +22 -0
  39. package/capabilities/architecture/templates/overview.md +24 -0
  40. package/capabilities/architecture/templates/project-map.md +26 -0
  41. package/capabilities/architecture/templates/review.md +23 -0
  42. package/capabilities/architecture/templates/solution-design.md +29 -0
  43. package/capabilities/architecture/workflows/change-review.md +12 -0
  44. package/capabilities/architecture/workflows/discovery-to-design.md +16 -0
  45. package/capabilities/delivery/README.md +11 -0
  46. package/capabilities/delivery/agents/project-manager.md +16 -0
  47. package/capabilities/delivery/capability.json +29 -0
  48. package/capabilities/delivery/checks/verification.json +29 -0
  49. package/capabilities/delivery/evals/cases.json +25 -0
  50. package/capabilities/delivery/skills/harness-delivery-planning/SKILL.md +43 -0
  51. package/capabilities/delivery/skills/harness-delivery-risk-management/SKILL.md +42 -0
  52. package/capabilities/delivery/skills/harness-delivery-scope-change/SKILL.md +43 -0
  53. package/capabilities/delivery/templates/change-assessment.md +23 -0
  54. package/capabilities/delivery/templates/delivery-plan.md +25 -0
  55. package/capabilities/delivery/templates/risk-register.md +19 -0
  56. package/capabilities/delivery/workflows/execution-change.md +9 -0
  57. package/capabilities/delivery/workflows/planning.md +12 -0
  58. package/capabilities/product/README.md +7 -0
  59. package/capabilities/product/agents/business-analyst.md +3 -0
  60. package/capabilities/product/agents/product-owner.md +5 -1
  61. package/capabilities/product/agents/project-manager.md +5 -0
  62. package/capabilities/product/capability.json +9 -4
  63. package/capabilities/product/checks/verification.json +12 -0
  64. package/capabilities/product/evals/cases.json +10 -0
  65. package/capabilities/product/skills/harness-product-acceptance-criteria/SKILL.md +17 -0
  66. package/capabilities/product/skills/harness-product-backlog-prioritization/SKILL.md +17 -0
  67. package/capabilities/product/skills/harness-product-brd-generation/SKILL.md +17 -0
  68. package/capabilities/product/skills/harness-product-business-analysis/SKILL.md +17 -0
  69. package/capabilities/product/skills/harness-product-document-review/SKILL.md +17 -0
  70. package/capabilities/product/skills/harness-product-idea-discovery/SKILL.md +17 -0
  71. package/capabilities/product/skills/harness-product-knowledge-analysis/SKILL.md +17 -0
  72. package/capabilities/product/skills/harness-product-mvp-definition/SKILL.md +43 -0
  73. package/capabilities/product/skills/harness-product-prd-generation/SKILL.md +17 -0
  74. package/capabilities/product/skills/harness-product-product-outcomes/SKILL.md +42 -0
  75. package/capabilities/product/skills/harness-product-product-research/SKILL.md +17 -0
  76. package/capabilities/product/skills/harness-product-srs-generation/SKILL.md +17 -0
  77. package/capabilities/product/skills/harness-product-traceability/SKILL.md +17 -0
  78. package/capabilities/product/skills/harness-product-use-case-generation/SKILL.md +17 -0
  79. package/capabilities/product/skills/harness-product-user-stories/SKILL.md +17 -0
  80. package/capabilities/product/templates/mvp.md +25 -0
  81. package/capabilities/product/templates/outcomes.md +23 -0
  82. package/capabilities/product/workflows/document-driven.md +4 -0
  83. package/capabilities/product/workflows/idea-driven.md +4 -0
  84. package/capabilities/product/workflows/product-to-solution.md +15 -0
  85. package/cli/agents.js +165 -0
  86. package/cli/environment.js +14 -1
  87. package/cli/harness.js +24 -9
  88. package/cli/main.js +19 -6
  89. package/config/agents.default.json +80 -0
  90. package/core/agents/documentation.md +13 -0
  91. package/core/agents/implementer.md +7 -0
  92. package/core/agents/orchestrator.md +13 -0
  93. package/core/agents/planner.md +4 -0
  94. package/core/agents/reviewer.md +8 -0
  95. package/core/checks/verification.json +37 -0
  96. package/core/evals/cases.json +70 -0
  97. package/core/evals/composition.json +15 -0
  98. package/core/rules/foundations.md +1 -0
  99. package/core/rules/project-conventions.md +61 -0
  100. package/core/workflows/agent-routing.md +28 -0
  101. package/core/workflows/bugfix.md +2 -0
  102. package/core/workflows/project-setup.md +9 -1
  103. package/core/workflows/solution-framing.md +33 -0
  104. package/core/workflows/spec-to-code.md +11 -3
  105. package/docs/README.md +39 -0
  106. package/docs/adapters.md +10 -2
  107. package/docs/agent-configuration.md +99 -0
  108. package/docs/agent-handoffs.md +23 -0
  109. package/docs/architecture.md +22 -1
  110. package/docs/cli.md +29 -4
  111. package/docs/documentation-workflows.md +7 -0
  112. package/docs/end-to-end-workflow.md +14 -1
  113. package/docs/examples/fullstack-web.md +4 -0
  114. package/docs/examples/react-native-app.md +4 -0
  115. package/docs/frontend-mobile.md +76 -0
  116. package/docs/getting-started.md +46 -78
  117. package/docs/harness-maintenance.md +80 -0
  118. package/docs/monetization.md +1 -1
  119. package/docs/project-configuration.md +4 -0
  120. package/docs/project-conventions.md +67 -0
  121. package/docs/research/solution-workflow-sources.md +30 -0
  122. package/docs/skill-matrix.md +34 -6
  123. package/docs/solution-workflow.md +67 -0
  124. package/docs/templates/harness-change-impact.md +30 -0
  125. package/docs/tool-setup/README.md +70 -0
  126. package/docs/tool-setup/claude-code.md +57 -0
  127. package/docs/tool-setup/codex.md +44 -0
  128. package/docs/tool-setup/copilot.md +42 -0
  129. package/docs/tool-setup/cursor.md +44 -0
  130. package/docs/tool-setup/gemini-cli.md +41 -0
  131. package/docs/versioning.md +38 -0
  132. package/evals/README.md +13 -0
  133. package/harness.yaml +4 -2
  134. package/package.json +2 -1
  135. package/templates/AGENTS.md +7 -0
  136. package/templates/openspec/design.md +6 -0
  137. package/templates/openspec/tasks.md +1 -0
@@ -0,0 +1,22 @@
1
+ # Quality scenarios
2
+
3
+ Status: draft / pending review
4
+ Owner: TODO
5
+ Sources and revisions: TODO
6
+ Scope / related requirement and decision IDs: TODO
7
+ Last verified against code: TODO (or not applicable with reason)
8
+
9
+ ## Drivers and evidence
10
+ MVP journey, users/data sensitivity, measured/expected load and financial/operational constraints.
11
+ ## Scenarios
12
+ | ID | Stimulus / conditions | Boundary / response | Measure / agreed target | Evidence / owner | Verification |
13
+ | --- | --- | --- | --- | --- | --- |
14
+ | NFR-001 | TODO | TODO | unknown / pending | TODO | TODO |
15
+ ## Trade-offs and failure policy
16
+ Security/correctness, availability/latency, recovery/RTO/RPO, cost and maintainability conflicts.
17
+ No assumed traffic, SLA or numerical target without authority.
18
+
19
+
20
+ ## Review and handoff
21
+ Record actual owner decisions, unresolved consequential questions, verification performed/skipped,
22
+ next role, source/output paths and affected OpenSpec change. Draft text is not an accepted decision.
@@ -0,0 +1,24 @@
1
+ # Solution overview
2
+
3
+ Status: draft / pending review
4
+ Owner: TODO
5
+ Sources and revisions: TODO
6
+ Scope / related requirement and decision IDs: TODO
7
+ Last verified against code: TODO (or not applicable with reason)
8
+
9
+ ## Purpose and limits
10
+ User outcomes/MVP, existing/new scope and explicit constraints; link BA/PRD/AC.
11
+ ## System context
12
+ Actors, systems, trust boundaries and deployment units. Use a compact C4-style context or Mermaid
13
+ only where relationships help. Every named system has a source or is marked hypothetical.
14
+ ## Responsibilities
15
+ Modules, data owners and public integration points; link the living project-map and accepted ADRs.
16
+ ## Quality drivers and options
17
+ NFR scenario links, top trade-offs, unknowns and owner decisions; minimal viable solution first.
18
+ ## Operating reality
19
+ Toolchain, deployment/observability/recovery constraints and authorized environments, linked to DevOps.
20
+
21
+
22
+ ## Review and handoff
23
+ Record actual owner decisions, unresolved consequential questions, verification performed/skipped,
24
+ next role, source/output paths and affected OpenSpec change. Draft text is not an accepted decision.
@@ -0,0 +1,26 @@
1
+ # Living project map
2
+
3
+ Status: draft / pending review
4
+ Owner: TODO
5
+ Sources and revisions: TODO
6
+ Scope / related requirement and decision IDs: TODO
7
+ Last verified against code: TODO (or not applicable with reason)
8
+
9
+ ## Freshness and scope
10
+ Verified source revision/date, inspected modules and inaccessible/unverified areas.
11
+ ## Ownership and dependencies
12
+ | Module / deployable | Responsibility / data owner | Public APIs / allowed dependencies | Code / tests / contract paths | ADR / NFR |
13
+ | --- | --- | --- | --- | --- |
14
+ | TODO | TODO | TODO | TODO | TODO |
15
+ ## Reusable common components
16
+ Public symbols, ownership, suitability constraints and actual paths; domain-private code is not common.
17
+ ## Decisions, risks and debt
18
+ Accepted/superseded ADRs, constraints and consciously accepted debt with owner/revisit condition.
19
+ ## Drift and refresh
20
+ Observed doc/code mismatch, affected source paths, proposed resolution and actual decision evidence.
21
+ Refresh the touched entries; do not regenerate the entire project for every task.
22
+
23
+
24
+ ## Review and handoff
25
+ Record actual owner decisions, unresolved consequential questions, verification performed/skipped,
26
+ next role, source/output paths and affected OpenSpec change. Draft text is not an accepted decision.
@@ -0,0 +1,23 @@
1
+ # Architecture review
2
+
3
+ Status: draft / pending review
4
+ Owner: TODO
5
+ Sources and revisions: TODO
6
+ Scope / related requirement and decision IDs: TODO
7
+ Last verified against code: TODO (or not applicable with reason)
8
+
9
+ ## Reviewed baseline
10
+ Source/diff revisions, accepted MVP/requirements/ADRs and declared scope of review.
11
+ ## Findings
12
+ | Severity | Location / scenario | Requirement / decision | Impact | Bounded remedy / owner |
13
+ | --- | --- | --- | --- | --- |
14
+ | TODO | TODO | TODO | TODO | TODO |
15
+ ## Evidence
16
+ Configured checks actually executed, logs/source pointers, manual boundary/failure review and skipped checks.
17
+ ## Disposition
18
+ Recommendation and remaining risk; author review is not independent approval, structure is not compliance.
19
+
20
+
21
+ ## Review and handoff
22
+ Record actual owner decisions, unresolved consequential questions, verification performed/skipped,
23
+ next role, source/output paths and affected OpenSpec change. Draft text is not an accepted decision.
@@ -0,0 +1,29 @@
1
+ # Solution design
2
+
3
+ Status: draft / pending review
4
+ Owner: TODO
5
+ Sources and revisions: TODO
6
+ Scope / related requirement and decision IDs: TODO
7
+ Last verified against code: TODO (or not applicable with reason)
8
+
9
+ ## Decision scope
10
+ Existing boundaries and required changes; distinguish deployment style, module design and local patterns.
11
+ ## Alternatives
12
+ | Option | Drivers it satisfies | Complexity / operations / cost | Risks / reversibility |
13
+ | --- | --- | --- | --- |
14
+ | TODO | TODO | TODO | TODO |
15
+ ## Recommended approach
16
+ Evidence-based recommendation, actual owner answer and ADR links; proposal is not approval.
17
+ ## Module, data and contract design
18
+ Responsibilities, public dependency direction, data ownership, API/event schemas, consistency and migrations.
19
+ ## Feature patterns
20
+ Concrete problem/variation, chosen pattern or direct code, reuse candidates and extra complexity rationale.
21
+ ## Important flows
22
+ Success/failure sequences: authorization, transaction, concurrency, timeout, retry/idempotency and recovery.
23
+ ## Implementation and release
24
+ Vertical slices, AC/NFR tests, observability, compatibility, rollout/rollback and known limits.
25
+
26
+
27
+ ## Review and handoff
28
+ Record actual owner decisions, unresolved consequential questions, verification performed/skipped,
29
+ next role, source/output paths and affected OpenSpec change. Draft text is not an accepted decision.
@@ -0,0 +1,12 @@
1
+ # Change impact and architecture review
2
+
3
+ Input: scoped request/diff, current map/ADRs and actual evidence. Output: bounded reviewed change,
4
+ updated affected context and explicit residual risk.
5
+ 1. Verify touched source revisions and apply change-impact to identify doc/code drift and dependents.
6
+ 2. Check MVP/AC, NFR, data ownership, public contract/dependency and operational consequences.
7
+ 3. Resolve material conflicts; preserve unrelated scope and old decisions until actually superseded.
8
+ 4. Update only affected ADR/map/contract pointers and OpenSpec tasks. Return value changes to PO and
9
+ sequencing/risk changes to Delivery. Avoid a full design pack for a small compatible fix.
10
+ 5. Use harness-architecture-review on design/diff with actual lint/test/build/boundary evidence.
11
+ State manual-only checks, skipped environments and author-vs-independent review explicitly.
12
+ 6. Handoff findings, source paths, decisions, IDs, pending work and next owner; release follows DevOps.
@@ -0,0 +1,16 @@
1
+ # Scope → solution design → implementation boundaries
2
+
3
+ Input: idea/reviewed BA documents or an existing project, actual source and Core context. Output:
4
+ reviewed solution decisions linked to requirements and OpenSpec; no mandatory full template set.
5
+ 1. Read `.harness/core/workflows/solution-framing.md`; establish mode/depth and preserve prior answers.
6
+ 2. Load harness-architecture-project-context. Verify the affected project map and existing decisions;
7
+ use an overview for new/material changes, compact source notes for a small task.
8
+ 3. Read reviewed MVP/AC or ask BA/PO about missing scope; use quality-attributes to identify testable
9
+ NFRs with real target authority. Unknown load/SLA/cost stays explicit.
10
+ 4. Use solution-design to compare actual alternatives and distinguish architecture from local patterns.
11
+ Recommend a minimal fit and ask only consequential unresolved questions with A/B/C trade-offs.
12
+ 5. Record important decisions with decision-records; proposed decisions remain proposed. Describe
13
+ public modules/data/contracts and critical success/failure paths with verification/rollout needs.
14
+ 6. Apply review. Hand approved scope/decisions and unresolved unaffected gaps to selected Product,
15
+ Delivery, DevOps or Core/adapter workflows. Record requirement/NFR/ADR IDs in OpenSpec design/tasks.
16
+ 7. Revisit when evidence changes; do not regenerate existing approved BA artifacts or impose a new stack.
@@ -0,0 +1,11 @@
1
+ # Delivery coordination
2
+
3
+ Optional instruction capability. Select with `aih init --capabilities delivery` or combine Product,
4
+ Architecture and Delivery; soft recommendations never auto-install other modules.
5
+ Read `workflows/planning.md` and only relevant skills. Project-owned outputs live in `docs/delivery/`;
6
+ `aih new-doc <type> --capability delivery` scaffolds a locked draft, does not fill or approve it.
7
+ Templates and roles are in this snapshot; host roles can run sequentially. Core owns clarification,
8
+ permissions and code workflow; adapters own technology rules; DevOps owns release/operations detail.
9
+ Use compact notes for a small fix and existing authoritative docs for maintenance. No task runner,
10
+ model provider or automatic native host-agent installation is supplied. `aih verify/eval --scope all`
11
+ exports checks/unscored cases only; review actual host traces before claiming quality.
@@ -0,0 +1,16 @@
1
+ # Project Manager
2
+
3
+ Tool-neutral role contract; one host can perform roles sequentially.
4
+
5
+ ## Inputs
6
+ Reviewed MVP/backlog, SA decisions, dependency graph, team estimates/capacity and actual progress.
7
+
8
+ ## Outputs
9
+ Delivery plan, risk register, change assessment and evidence-based status drafts.
10
+
11
+ ## Permissions and limits
12
+ Dates, budgets and assignments remain proposals until confirmed. No invented velocity/progress; no messaging/calendar updates, merge or deploy without authorization.
13
+
14
+ ## Handoff
15
+ Return value/scope decisions to PO, design dependencies to SA, release gates to DevOps and approved slices to Core implementation; record actual evidence and blockers.
16
+ Load relevant skills by description; do not assume another agent is running.
@@ -0,0 +1,29 @@
1
+ {
2
+ "schema_version": 1,
3
+ "id": "delivery",
4
+ "description": "Evidence-based delivery plans, dependencies, risks and scope-change coordination.",
5
+ "skills": [
6
+ "harness-delivery-planning",
7
+ "harness-delivery-risk-management",
8
+ "harness-delivery-scope-change"
9
+ ],
10
+ "templates": [
11
+ "templates/delivery-plan.md",
12
+ "templates/risk-register.md",
13
+ "templates/change-assessment.md"
14
+ ],
15
+ "agents": [
16
+ "agents/project-manager.md"
17
+ ],
18
+ "workflows": [
19
+ "workflows/planning.md",
20
+ "workflows/execution-change.md"
21
+ ],
22
+ "module_version": "1.0.0",
23
+ "recommends": [
24
+ "capability:product",
25
+ "capability:architecture"
26
+ ],
27
+ "verification": "checks/verification.json",
28
+ "evaluation": "evals/cases.json"
29
+ }
@@ -0,0 +1,29 @@
1
+ {
2
+ "schema_version": 1,
3
+ "checks": [
4
+ {
5
+ "id": "plan-evidence",
6
+ "title": "Review delivery plan authority",
7
+ "command": [],
8
+ "when_file": null,
9
+ "evidence": [
10
+ "Value slices and requirement/ADR/OpenSpec links",
11
+ "Dependency owners and estimate/capacity source or unknown",
12
+ "Actual completion evidence, risks and release/rollback handoff"
13
+ ],
14
+ "execution": "manual"
15
+ },
16
+ {
17
+ "id": "scope-change",
18
+ "title": "Review changed scope and commitments",
19
+ "command": [],
20
+ "when_file": null,
21
+ "evidence": [
22
+ "Baseline/delta and actual owner decision",
23
+ "Product/architecture/release impact",
24
+ "No invented schedule, progress or stakeholder messaging"
25
+ ],
26
+ "execution": "manual"
27
+ }
28
+ ]
29
+ }
@@ -0,0 +1,25 @@
1
+ {
2
+ "schema_version": 1,
3
+ "cases": [
4
+ {
5
+ "id": "no-invented-deadline",
6
+ "prompt": "The user wants the entire enterprise MVP next Friday but no estimates, capacity or external dependency confirmations exist.",
7
+ "criteria": [
8
+ "Proposes usable slice order and explicit dependencies",
9
+ "Does not invent velocity, capacity or claim a committed date",
10
+ "Offers scope trade-offs and requests actual estimate/owner decisions while continuing independent work"
11
+ ],
12
+ "critical": true
13
+ },
14
+ {
15
+ "id": "scope-delta",
16
+ "prompt": "After an approved customer-search MVP, bulk import is requested without changing the date. Schema, async execution and duplicate policy are unresolved.",
17
+ "criteria": [
18
+ "Preserves baseline and assesses product/architecture/dependency/release impact",
19
+ "Presents defer/replace/expand trade-offs without unsupported time/cost claims",
20
+ "Records actual owner answer before affected implementation and updates traceability/plan"
21
+ ],
22
+ "critical": true
23
+ }
24
+ ]
25
+ }
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: harness-delivery-planning
3
+ description: Plan value-bearing delivery slices and dependencies from reviewed scope and team-supplied estimates.
4
+ ---
5
+
6
+ # harness-delivery-planning
7
+
8
+ ## Input
9
+ Reviewed MVP/backlog, architecture decisions, dependency graph, actual capacity/estimates and release constraints.
10
+
11
+ ## Procedure
12
+ 1. Identify deployable vertical outcomes, acceptance criteria and prerequisites; avoid one disconnected layer per milestone.
13
+ 2. Map task/repository/owner dependencies and integration order; expose critical blockers and external confirmations.
14
+ 3. Use team estimates and known capacity, record ranges/assumptions; when absent propose order, not invented dates or velocity.
15
+ 4. Define completion evidence and planned quality/security/architecture gates proportional to risk.
16
+ 5. Include migration/release/rollback responsibilities with DevOps, and feedback checkpoints with PO.
17
+ 6. Publish a plan draft for actual owner review; update status only from observed completed work and source links.
18
+
19
+ ## Output
20
+ docs/delivery/delivery-plan.md linked to stories, ADRs, OpenSpec tasks and risks.
21
+
22
+ ## Template
23
+ Read `.harness/capabilities/delivery/templates/delivery-plan.md` from the installed snapshot.
24
+ Use `aih new-doc delivery-plan --capability delivery` only for a missing draft;
25
+ reuse existing authoritative docs or a compact task note when appropriate. Never overwrite approved content.
26
+
27
+ ## Example
28
+ Customer-search delivery: authorization + create + query + tests form the first usable slice. Bulk import follows schema readiness. With no capacity estimate, order the slices and label dates unknown.
29
+
30
+ ## Quality checklist
31
+ - Every slice has user value and observable acceptance
32
+ - Dependencies and accountable owners are explicit
33
+ - Dates/capacity have sources and completion has evidence
34
+
35
+ ## Handoff
36
+ State source revisions, requirement/decision IDs, approval status, unresolved questions, output paths,
37
+ actual checks and next role. Use the module workflow; role names are not human authorization.
38
+
39
+ ## Constraints
40
+ Follow Core permissions, clarification and project-conventions. Ask only consequential unknowns with
41
+ 2–3 distinct options, evidence-based recommendation and free text; reuse established answers.
42
+ No invented source, measured result, target, estimate or approval. No external messaging/publishing,
43
+ paid tool use or production changes beyond the user's explicit authorization.
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: harness-delivery-risk-management
3
+ description: Maintain owned delivery risks, assumptions, blockers and dependencies with response triggers.
4
+ ---
5
+
6
+ # harness-delivery-risk-management
7
+
8
+ ## Input
9
+ Plan, stakeholder/source constraints, technical/operational findings and actual progress evidence.
10
+
11
+ ## Procedure
12
+ 1. Identify risks versus current issues, assumptions and dependencies; link each to source and affected outcome.
13
+ 2. Assess impact and likelihood qualitatively or with actual evidence; do not invent numerical risk scores.
14
+ 3. Assign proposed/confirmed owner, mitigation, trigger, contingency and decision needed; clarify critical gaps.
15
+ 4. Track unresolved external dependencies and review cadence; no autonomous stakeholder messages or calendar writes.
16
+ 5. Update risk state only with evidence; carry accepted residual risks to release/PO decision and architecture review.
17
+
18
+ ## Output
19
+ docs/delivery/risk-register.md and evidence-based status draft.
20
+
21
+ ## Template
22
+ Read `.harness/capabilities/delivery/templates/risk-register.md` from the installed snapshot.
23
+ Use `aih new-doc risk-register --capability delivery` only for a missing draft;
24
+ reuse existing authoritative docs or a compact task note when appropriate. Never overwrite approved content.
25
+
26
+ ## Example
27
+ Internal provider sandbox is unreachable: current blocker, not a completed test. Owner confirms access plan; integration milestone remains at risk until an observed connectivity check succeeds.
28
+
29
+ ## Quality checklist
30
+ - Risk and observed issue are distinguished
31
+ - Owner, trigger, response and source are present
32
+ - Status does not fabricate progress or communicate externally
33
+
34
+ ## Handoff
35
+ State source revisions, requirement/decision IDs, approval status, unresolved questions, output paths,
36
+ actual checks and next role. Use the module workflow; role names are not human authorization.
37
+
38
+ ## Constraints
39
+ Follow Core permissions, clarification and project-conventions. Ask only consequential unknowns with
40
+ 2–3 distinct options, evidence-based recommendation and free text; reuse established answers.
41
+ No invented source, measured result, target, estimate or approval. No external messaging/publishing,
42
+ paid tool use or production changes beyond the user's explicit authorization.
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: harness-delivery-scope-change
3
+ description: Evaluate scope changes across product value, architecture, dependencies and delivery before re-planning.
4
+ ---
5
+
6
+ # harness-delivery-scope-change
7
+
8
+ ## Input
9
+ Change request, reviewed baseline scope/MVP, affected requirements/ADRs, plan and available estimates.
10
+
11
+ ## Procedure
12
+ 1. Preserve the baseline and describe the proposed delta and motivation; identify decision owner.
13
+ 2. Ask BA/PO for requirement/value/AC impact, SA for contract/NFR/data impact and DevOps for release impact as applicable.
14
+ 3. Compare defer, replace and expand options with explicit trade-offs; avoid invented cost/dates.
15
+ 4. Resolve consequential owner decisions before implementing affected behavior; continue independent authorized work.
16
+ 5. Update only affected scope/traceability/ADR/plan records and OpenSpec tasks after the real decision.
17
+ 6. Report revised dependencies, acceptance, risks and rollback considerations; preserve history.
18
+
19
+ ## Output
20
+ docs/delivery/change-assessment.md and reviewed updates to existing plan/requirements/design.
21
+
22
+ ## Template
23
+ Read `.harness/capabilities/delivery/templates/change-assessment.md` from the installed snapshot.
24
+ Use `aih new-doc change-assessment --capability delivery` only for a missing draft;
25
+ reuse existing authoritative docs or a compact task note when appropriate. Never overwrite approved content.
26
+
27
+ ## Example
28
+ Adding bulk import to the search MVP requires async jobs, limits and duplicate policy. Present defer or replace a lower-value feature; do not quietly promise the same release date.
29
+
30
+ ## Quality checklist
31
+ - Baseline and delta are explicit and source-linked
32
+ - Cross-role impacts and options are assessed
33
+ - Scope/date approval is from the actual owner
34
+
35
+ ## Handoff
36
+ State source revisions, requirement/decision IDs, approval status, unresolved questions, output paths,
37
+ actual checks and next role. Use the module workflow; role names are not human authorization.
38
+
39
+ ## Constraints
40
+ Follow Core permissions, clarification and project-conventions. Ask only consequential unknowns with
41
+ 2–3 distinct options, evidence-based recommendation and free text; reuse established answers.
42
+ No invented source, measured result, target, estimate or approval. No external messaging/publishing,
43
+ paid tool use or production changes beyond the user's explicit authorization.
@@ -0,0 +1,23 @@
1
+ # Scope change assessment
2
+
3
+ Status: draft / pending review
4
+ Owner: TODO
5
+ Sources and revisions: TODO
6
+ Scope / related requirement and decision IDs: TODO
7
+ Last verified against code: TODO (or not applicable with reason)
8
+
9
+ ## Baseline and requested delta
10
+ Approved scope/version, request/source, motivation and actual decision owner.
11
+ ## Cross-role impact
12
+ BA requirements/AC, PO value/MVP, SA NFR/module/data/contracts, PM dependency/estimate and DevOps release.
13
+ ## Options
14
+ Defer, replace or expand where viable; value, risk, estimate confidence and rollback trade-offs.
15
+ ## Resolution and updates
16
+ Actual owner answer/source; impacted docs, traceability, ADRs, tasks and plan updates after agreement.
17
+ ## Remaining uncertainty
18
+ Unknown estimates/targets, external dependencies, blockers and independent work that can proceed.
19
+
20
+
21
+ ## Review and handoff
22
+ Record actual owner decisions, unresolved consequential questions, verification performed/skipped,
23
+ next role, source/output paths and affected OpenSpec change. Draft text is not an accepted decision.
@@ -0,0 +1,25 @@
1
+ # Delivery plan
2
+
3
+ Status: draft / pending review
4
+ Owner: TODO
5
+ Sources and revisions: TODO
6
+ Scope / related requirement and decision IDs: TODO
7
+ Last verified against code: TODO (or not applicable with reason)
8
+
9
+ ## Baseline and authority
10
+ Reviewed MVP/AC, architecture/source revisions, confirmed estimates/capacity or explicitly unknown.
11
+ ## Value slices and dependencies
12
+ | Slice / user outcome | AC / OpenSpec tasks | Prerequisites / owner | Estimate source / range | Completion evidence |
13
+ | --- | --- | --- | --- | --- |
14
+ | TODO | TODO | TODO | unknown | pending |
15
+ ## Milestones
16
+ Order and integration/repository merge sequence; dates are proposals with sources, not invented commitments.
17
+ ## Verification and release
18
+ Quality gates, migration, deployment/rollback owners and feedback checkpoints; link DevOps plan.
19
+ ## Status and risks
20
+ Actual completed evidence, blocked/pending work, risk-register links and next owner.
21
+
22
+
23
+ ## Review and handoff
24
+ Record actual owner decisions, unresolved consequential questions, verification performed/skipped,
25
+ next role, source/output paths and affected OpenSpec change. Draft text is not an accepted decision.
@@ -0,0 +1,19 @@
1
+ # Delivery risks and blockers
2
+
3
+ Status: draft / pending review
4
+ Owner: TODO
5
+ Sources and revisions: TODO
6
+ Scope / related requirement and decision IDs: TODO
7
+ Last verified against code: TODO (or not applicable with reason)
8
+
9
+ ## Risk / issue / assumption / dependency register
10
+ | ID / kind | Source / affected outcome | Impact / likelihood evidence | Owner status | Response / trigger / contingency | State / evidence |
11
+ | --- | --- | --- | --- | --- | --- |
12
+ | RISK-001 / TODO | TODO | unknown | proposed | TODO | pending |
13
+ ## Review cadence and decisions
14
+ Actual confirmations, residual risk acceptances and decisions needed; no automatic stakeholder communication.
15
+
16
+
17
+ ## Review and handoff
18
+ Record actual owner decisions, unresolved consequential questions, verification performed/skipped,
19
+ next role, source/output paths and affected OpenSpec change. Draft text is not an accepted decision.
@@ -0,0 +1,9 @@
1
+ # Progress, feedback and scope changes
2
+
3
+ 1. Read actual completed check/PR evidence against the current plan; do not infer completion from tasks alone.
4
+ 2. Maintain risk-register with source, confirmed/proposed owners, triggers and unresolved external dependencies.
5
+ 3. For changed scope load scope-change: preserve baseline, consult BA/PO/SA/DevOps as relevant, compare
6
+ defer/replace/expand and resolve material choices. Continue independent already-authorized work.
7
+ 4. Update affected plan, requirements, ADRs and OpenSpec only after the actual decision; keep history.
8
+ 5. Produce a status draft with completed/pending/blocked work and evidence. Release ownership/gates
9
+ remain in DevOps; PM proposals do not approve delivery or production changes.
@@ -0,0 +1,12 @@
1
+ # Reviewed outcome → delivery plan
2
+
3
+ Input: agreed scope/MVP, acceptance, solution boundaries and known team constraints.
4
+ 1. Read Core solution-framing and existing approved plan; choose compact or full depth.
5
+ 2. Load harness-delivery-planning for usable vertical slices, dependencies, repository order and gates.
6
+ 3. Use actual team estimates/capacity; without them document sequencing and missing estimate owners,
7
+ not fabricated milestones. Compare scope trade-offs with PO and technical dependencies with SA.
8
+ 4. Load risk-management for owned risks/blockers/assumptions/dependencies and response triggers.
9
+ 5. Link plan to requirements/ADRs/OpenSpec tasks and DevOps rollout/rollback. Actual owner reviews
10
+ consequential commitments; explicit authorization already covering routine tasks remains valid.
11
+ 6. Handoff approved slice, acceptance, prerequisites, verification, risks and next owner to Core/adapter.
12
+ No automatic issue assignment, messaging, calendar entries, merge or deployment.
@@ -76,3 +76,10 @@ After documented approval, UI/UX reads approved PRD, flows, stories and AC rathe
76
76
  ## Cross-capability walkthrough
77
77
 
78
78
  The complete path from source/idea to production is documented in [Full SDLC](../../docs/end-to-end-workflow.md). The [Skill matrix](../../docs/skill-matrix.md) maps all Product skills and outputs, and [Agent handoffs](../../docs/agent-handoffs.md) shows how approved requirements pass to UI/UX and OpenSpec. For an example, see [Full-stack web](../../docs/examples/fullstack-web.md).
79
+
80
+ ## MVP and solution handoff
81
+
82
+ Use product-to-solution workflow, MVP/outcomes skills and their templates; load only relevant skills.
83
+ Optional Architecture/Delivery provides SA/PM depth. Existing Product project-manager and delivery-plan
84
+ remain compatibility entries; no automatic migration or stakeholder approval. All Product skills now
85
+ include template/example/quality/handoff sections.
@@ -13,3 +13,6 @@ Read approved business sources only. Cannot invent stakeholder decisions or mark
13
13
 
14
14
  ## Handoff
15
15
  Hand reviewed requirements and source references to Product Manager and Product Owner; unresolved contradictions to decision owner.
16
+
17
+ Pass source revisions, business rules, FR/US/AC/NFR IDs, contradictions and approval status to PO;
18
+ use product-to-solution for accepted scope and return technical assumptions to Architecture.
@@ -6,10 +6,14 @@ Owns proposed backlog structure, story readiness, acceptance coverage and priori
6
6
  Reviewed PRD, business rules, personas, constraints and team capacity signals.
7
7
 
8
8
  ## Outputs
9
- Epics, user stories, Gherkin acceptance criteria, backlog priority recommendations and release dependencies.
9
+ Reviewed-scope proposals for complete MVP journeys, in/out scope, minimum quality, product outcome
10
+ measures, epics/stories, Gherkin AC, priorities and release dependencies.
10
11
 
11
12
  ## Permissions and limits
12
13
  Do not self-approve or silently change stakeholder priorities; no invented sprint velocity or technical guarantees.
13
14
 
14
15
  ## Handoff
15
16
  Hand approved stories and traceable AC to UI/UX and OpenSpec; return gaps to BA/PM.
17
+
18
+ Use product-to-solution workflow and MVP/outcomes skills; actual stakeholder decisions remain required
19
+ for consequential scope choices. Send requirement/AC/NFR IDs and decision evidence to Architecture/Delivery.
@@ -13,3 +13,8 @@ Schedules are proposals without team estimates and confirmations. No calendar/ev
13
13
 
14
14
  ## Handoff
15
15
  Send dependencies and risks to responsible owners, and scope-change impacts to Product Owner.
16
+
17
+ Compatibility entry point: retain this role and the existing Product delivery-plan template for older
18
+ consumers. For richer delivery planning, use the installed Delivery project-manager role/workflows
19
+ when selected; otherwise keep sequencing/risks in existing project-owned docs. Do not auto-install it
20
+ or migrate/overwrite the old plan. Project Manager manages delivery; Product Manager owns product value.
@@ -15,14 +15,17 @@
15
15
  "harness-product-idea-discovery",
16
16
  "harness-product-product-research",
17
17
  "harness-product-srs-generation",
18
- "harness-product-use-case-generation"
18
+ "harness-product-use-case-generation",
19
+ "harness-product-mvp-definition",
20
+ "harness-product-product-outcomes"
19
21
  ],
20
22
  "workflows": [
21
23
  "workflows/idea-to-prd.md",
22
24
  "workflows/confluence-to-spec.md",
23
25
  "workflows/change-impact-analysis.md",
24
26
  "workflows/idea-driven.md",
25
- "workflows/document-driven.md"
27
+ "workflows/document-driven.md",
28
+ "workflows/product-to-solution.md"
26
29
  ],
27
30
  "agents": [
28
31
  "agents/business-analyst.md",
@@ -47,9 +50,11 @@
47
50
  "templates/research.md",
48
51
  "templates/prd-lite.md",
49
52
  "templates/srs.md",
50
- "templates/use-cases.md"
53
+ "templates/use-cases.md",
54
+ "templates/mvp.md",
55
+ "templates/outcomes.md"
51
56
  ],
52
- "module_version": "1.1.0",
57
+ "module_version": "1.2.0",
53
58
  "verification": "checks/verification.json",
54
59
  "evaluation": "evals/cases.json"
55
60
  }
@@ -36,6 +36,18 @@
36
36
  "OpenSpec handoff references approved scope only"
37
37
  ],
38
38
  "execution": "manual"
39
+ },
40
+ {
41
+ "id": "mvp-outcome",
42
+ "title": "MVP completeness and product outcome authority",
43
+ "command": [],
44
+ "when_file": null,
45
+ "evidence": [
46
+ "Usable end-to-end journey, explicit in/out scope and requirement/AC links",
47
+ "Minimum security/data integrity included",
48
+ "Metrics/targets and scope approval source or unresolved owner"
49
+ ],
50
+ "execution": "manual"
39
51
  }
40
52
  ]
41
53
  }
@@ -30,6 +30,16 @@
30
30
  "Hands off only approved FR/NFR/US/AC and explicit source versions to OpenSpec"
31
31
  ],
32
32
  "critical": true
33
+ },
34
+ {
35
+ "id": "mvp-not-feature-count",
36
+ "prompt": "A user wants a customer search MVP, suggests skipping authorization and duplicate handling until later, and provides no approved success target.",
37
+ "criteria": [
38
+ "Defines a usable journey and explicit in/out scope with acceptance",
39
+ "Keeps minimum access control/data integrity and clarifies duplicate policy",
40
+ "Does not invent success metrics or approve the MVP on behalf of the owner"
41
+ ],
42
+ "critical": true
33
43
  }
34
44
  ]
35
45
  }