@agent-ix/quoin 0.23.1 → 0.26.1
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 +8 -258
- package/bin/launcher.js +138 -0
- package/package.json +22 -123
- package/.agents/plugins/marketplace.json +0 -14
- package/.claude-plugin/marketplace.json +0 -16
- package/.claude-plugin/plugin.json +0 -8
- package/.codex-plugin/plugin.json +0 -27
- package/.github/plugin/marketplace.json +0 -16
- package/bin/quoin.js +0 -21
- package/default-modules.yaml +0 -107
- package/dist/advisor/advise.d.ts +0 -199
- package/dist/advisor/advise.d.ts.map +0 -1
- package/dist/advisor/index.d.ts +0 -10
- package/dist/advisor/index.d.ts.map +0 -1
- package/dist/advisor/methods.d.ts +0 -60
- package/dist/advisor/methods.d.ts.map +0 -1
- package/dist/advisor-B0rESCx1.js +0 -63
- package/dist/assurance/graph.d.ts +0 -87
- package/dist/assurance/graph.d.ts.map +0 -1
- package/dist/assurance/index.d.ts +0 -9
- package/dist/assurance/index.d.ts.map +0 -1
- package/dist/assurance/render.d.ts +0 -3
- package/dist/assurance/render.d.ts.map +0 -1
- package/dist/auditor/audit.d.ts +0 -146
- package/dist/auditor/audit.d.ts.map +0 -1
- package/dist/auditor/combinatorial.d.ts +0 -53
- package/dist/auditor/combinatorial.d.ts.map +0 -1
- package/dist/auditor/index.d.ts +0 -9
- package/dist/auditor/index.d.ts.map +0 -1
- package/dist/auditor-Dd3i9Aqx.js +0 -340
- package/dist/base-gAClyCNd.js +0 -137
- package/dist/base.d.ts +0 -23
- package/dist/base.d.ts.map +0 -1
- package/dist/catalog.d.ts +0 -33
- package/dist/catalog.d.ts.map +0 -1
- package/dist/change-assurance/attestations.d.ts +0 -7
- package/dist/change-assurance/attestations.d.ts.map +0 -1
- package/dist/change-assurance/index.d.ts +0 -14
- package/dist/change-assurance/index.d.ts.map +0 -1
- package/dist/change-assurance/integrity.d.ts +0 -11
- package/dist/change-assurance/integrity.d.ts.map +0 -1
- package/dist/change-assurance/records.d.ts +0 -22
- package/dist/change-assurance/records.d.ts.map +0 -1
- package/dist/change-assurance/schema-assets.d.ts +0 -8
- package/dist/change-assurance/schema-assets.d.ts.map +0 -1
- package/dist/change-assurance/store.d.ts +0 -18
- package/dist/change-assurance/store.d.ts.map +0 -1
- package/dist/change-assurance/types.d.ts +0 -180
- package/dist/change-assurance/types.d.ts.map +0 -1
- package/dist/change-assurance/verify.d.ts +0 -4
- package/dist/change-assurance/verify.d.ts.map +0 -1
- package/dist/change-assurance-CyKLPeKa.js +0 -1236
- package/dist/cli.d.ts +0 -61
- package/dist/cli.d.ts.map +0 -1
- package/dist/cli.js +0 -34
- package/dist/commands/advise.d.ts +0 -16
- package/dist/commands/advise.d.ts.map +0 -1
- package/dist/commands/advise.js +0 -234
- package/dist/commands/assurance.d.ts +0 -14
- package/dist/commands/assurance.d.ts.map +0 -1
- package/dist/commands/assurance.js +0 -204
- package/dist/commands/catalog/index.d.ts +0 -2
- package/dist/commands/catalog/index.d.ts.map +0 -1
- package/dist/commands/catalog/index.js +0 -2
- package/dist/commands/catalog/list.d.ts +0 -11
- package/dist/commands/catalog/list.d.ts.map +0 -1
- package/dist/commands/catalog/list.js +0 -22
- package/dist/commands/catalog/methods.d.ts +0 -12
- package/dist/commands/catalog/methods.d.ts.map +0 -1
- package/dist/commands/catalog/methods.js +0 -43
- package/dist/commands/catalog/show.d.ts +0 -13
- package/dist/commands/catalog/show.d.ts.map +0 -1
- package/dist/commands/catalog/show.js +0 -25
- package/dist/commands/catalog/validate.d.ts +0 -10
- package/dist/commands/catalog/validate.d.ts.map +0 -1
- package/dist/commands/catalog/validate.js +0 -27
- package/dist/commands/change-assurance/common.d.ts +0 -37
- package/dist/commands/change-assurance/common.d.ts.map +0 -1
- package/dist/commands/change-assurance/index.d.ts +0 -8
- package/dist/commands/change-assurance/index.d.ts.map +0 -1
- package/dist/commands/change-assurance/index.js +0 -12
- package/dist/commands/change-assurance/intake.d.ts +0 -15
- package/dist/commands/change-assurance/intake.d.ts.map +0 -1
- package/dist/commands/change-assurance/intake.js +0 -53
- package/dist/commands/change-assurance/receipt.d.ts +0 -21
- package/dist/commands/change-assurance/receipt.d.ts.map +0 -1
- package/dist/commands/change-assurance/receipt.js +0 -99
- package/dist/commands/change-assurance/recover.d.ts +0 -13
- package/dist/commands/change-assurance/recover.d.ts.map +0 -1
- package/dist/commands/change-assurance/recover.js +0 -29
- package/dist/commands/change-assurance/schema.d.ts +0 -13
- package/dist/commands/change-assurance/schema.d.ts.map +0 -1
- package/dist/commands/change-assurance/schema.js +0 -40
- package/dist/commands/change-assurance/seal-attestation.d.ts +0 -15
- package/dist/commands/change-assurance/seal-attestation.d.ts.map +0 -1
- package/dist/commands/change-assurance/seal-attestation.js +0 -58
- package/dist/commands/change-assurance/seal-record.d.ts +0 -14
- package/dist/commands/change-assurance/seal-record.d.ts.map +0 -1
- package/dist/commands/change-assurance/seal-record.js +0 -53
- package/dist/commands/change-assurance/verify-receipt.d.ts +0 -13
- package/dist/commands/change-assurance/verify-receipt.d.ts.map +0 -1
- package/dist/commands/change-assurance/verify-receipt.js +0 -41
- package/dist/commands/completeness.d.ts +0 -16
- package/dist/commands/completeness.d.ts.map +0 -1
- package/dist/commands/completeness.js +0 -49
- package/dist/commands/config/doctor.d.ts +0 -7
- package/dist/commands/config/doctor.d.ts.map +0 -1
- package/dist/commands/config/doctor.js +0 -15
- package/dist/commands/config/edit.d.ts +0 -7
- package/dist/commands/config/edit.d.ts.map +0 -1
- package/dist/commands/config/edit.js +0 -13
- package/dist/commands/config/get.d.ts +0 -11
- package/dist/commands/config/get.d.ts.map +0 -1
- package/dist/commands/config/get.js +0 -20
- package/dist/commands/config/index.d.ts +0 -2
- package/dist/commands/config/index.d.ts.map +0 -1
- package/dist/commands/config/index.js +0 -2
- package/dist/commands/config/set.d.ts +0 -12
- package/dist/commands/config/set.d.ts.map +0 -1
- package/dist/commands/config/set.js +0 -26
- package/dist/commands/evidence/affirm.d.ts +0 -17
- package/dist/commands/evidence/affirm.d.ts.map +0 -1
- package/dist/commands/evidence/affirm.js +0 -65
- package/dist/commands/evidence/audit.d.ts +0 -34
- package/dist/commands/evidence/audit.d.ts.map +0 -1
- package/dist/commands/evidence/audit.js +0 -107
- package/dist/commands/evidence/baseline.d.ts +0 -14
- package/dist/commands/evidence/baseline.d.ts.map +0 -1
- package/dist/commands/evidence/baseline.js +0 -89
- package/dist/commands/evidence/gc.d.ts +0 -13
- package/dist/commands/evidence/gc.d.ts.map +0 -1
- package/dist/commands/evidence/gc.js +0 -35
- package/dist/commands/evidence/index.d.ts +0 -8
- package/dist/commands/evidence/index.d.ts.map +0 -1
- package/dist/commands/evidence/index.js +0 -18
- package/dist/commands/evidence/inspect-mocks.d.ts +0 -16
- package/dist/commands/evidence/inspect-mocks.d.ts.map +0 -1
- package/dist/commands/evidence/inspect-mocks.js +0 -49
- package/dist/commands/evidence/record.d.ts +0 -22
- package/dist/commands/evidence/record.d.ts.map +0 -1
- package/dist/commands/evidence/record.js +0 -144
- package/dist/commands/graph/change-impact.d.ts +0 -16
- package/dist/commands/graph/change-impact.d.ts.map +0 -1
- package/dist/commands/graph/change-impact.js +0 -29
- package/dist/commands/graph/churn.d.ts +0 -14
- package/dist/commands/graph/churn.d.ts.map +0 -1
- package/dist/commands/graph/churn.js +0 -15
- package/dist/commands/graph/common.d.ts +0 -16
- package/dist/commands/graph/common.d.ts.map +0 -1
- package/dist/commands/graph/fan-out.d.ts +0 -14
- package/dist/commands/graph/fan-out.d.ts.map +0 -1
- package/dist/commands/graph/fan-out.js +0 -15
- package/dist/commands/graph/index.d.ts +0 -8
- package/dist/commands/graph/index.d.ts.map +0 -1
- package/dist/commands/graph/index.js +0 -12
- package/dist/commands/matrix.d.ts +0 -14
- package/dist/commands/matrix.d.ts.map +0 -1
- package/dist/commands/matrix.js +0 -15
- package/dist/commands/measurement/index.d.ts +0 -7
- package/dist/commands/measurement/index.d.ts.map +0 -1
- package/dist/commands/measurement/index.js +0 -11
- package/dist/commands/measurement/intervention.d.ts +0 -11
- package/dist/commands/measurement/intervention.d.ts.map +0 -1
- package/dist/commands/measurement/intervention.js +0 -31
- package/dist/commands/measurement/operational-release.d.ts +0 -11
- package/dist/commands/measurement/operational-release.d.ts.map +0 -1
- package/dist/commands/measurement/operational-release.js +0 -31
- package/dist/commands/measurement/record.d.ts +0 -10
- package/dist/commands/measurement/record.d.ts.map +0 -1
- package/dist/commands/measurement/record.js +0 -36
- package/dist/commands/module/ensure-defaults.d.ts +0 -8
- package/dist/commands/module/ensure-defaults.d.ts.map +0 -1
- package/dist/commands/module/ensure-defaults.js +0 -17
- package/dist/commands/module/index.d.ts +0 -2
- package/dist/commands/module/index.d.ts.map +0 -1
- package/dist/commands/module/index.js +0 -2
- package/dist/commands/module/install.d.ts +0 -11
- package/dist/commands/module/install.d.ts.map +0 -1
- package/dist/commands/module/install.js +0 -22
- package/dist/commands/module/list.d.ts +0 -8
- package/dist/commands/module/list.d.ts.map +0 -1
- package/dist/commands/module/list.js +0 -13
- package/dist/commands/module/remove.d.ts +0 -10
- package/dist/commands/module/remove.d.ts.map +0 -1
- package/dist/commands/module/remove.js +0 -16
- package/dist/commands/plugin/deprecation.d.ts +0 -10
- package/dist/commands/plugin/deprecation.d.ts.map +0 -1
- package/dist/commands/plugin/ensure-defaults.d.ts +0 -8
- package/dist/commands/plugin/ensure-defaults.d.ts.map +0 -1
- package/dist/commands/plugin/ensure-defaults.js +0 -12
- package/dist/commands/plugin/index.d.ts +0 -2
- package/dist/commands/plugin/index.d.ts.map +0 -1
- package/dist/commands/plugin/index.js +0 -2
- package/dist/commands/plugin/install.d.ts +0 -8
- package/dist/commands/plugin/install.d.ts.map +0 -1
- package/dist/commands/plugin/install.js +0 -12
- package/dist/commands/plugin/list.d.ts +0 -8
- package/dist/commands/plugin/list.d.ts.map +0 -1
- package/dist/commands/plugin/list.js +0 -12
- package/dist/commands/plugin/remove.d.ts +0 -8
- package/dist/commands/plugin/remove.d.ts.map +0 -1
- package/dist/commands/plugin/remove.js +0 -12
- package/dist/commands/report.d.ts +0 -19
- package/dist/commands/report.d.ts.map +0 -1
- package/dist/commands/report.js +0 -96
- package/dist/commands/review.d.ts +0 -14
- package/dist/commands/review.d.ts.map +0 -1
- package/dist/commands/review.js +0 -15
- package/dist/commands/to-plan.d.ts +0 -14
- package/dist/commands/to-plan.d.ts.map +0 -1
- package/dist/commands/to-plan.js +0 -15
- package/dist/commands/update.d.ts +0 -13
- package/dist/commands/update.d.ts.map +0 -1
- package/dist/commands/update.js +0 -34
- package/dist/commands/validate.d.ts +0 -13
- package/dist/commands/validate.d.ts.map +0 -1
- package/dist/commands/validate.js +0 -123
- package/dist/commands/write.d.ts +0 -16
- package/dist/commands/write.d.ts.map +0 -1
- package/dist/commands/write.js +0 -33
- package/dist/common-B1ZJ8CSO.js +0 -36
- package/dist/common-DTrmnvL-.js +0 -35
- package/dist/completeness/assess.d.ts +0 -82
- package/dist/completeness/assess.d.ts.map +0 -1
- package/dist/completeness/bundle.d.ts +0 -52
- package/dist/completeness/bundle.d.ts.map +0 -1
- package/dist/completeness/declarations.d.ts +0 -46
- package/dist/completeness/declarations.d.ts.map +0 -1
- package/dist/completeness/index.d.ts +0 -11
- package/dist/completeness/index.d.ts.map +0 -1
- package/dist/completeness/run.d.ts +0 -35
- package/dist/completeness/run.d.ts.map +0 -1
- package/dist/completeness-BzBuNq6w.js +0 -228
- package/dist/config-schema-Dp-vlxuR.js +0 -13
- package/dist/config-schema.d.ts +0 -52
- package/dist/config-schema.d.ts.map +0 -1
- package/dist/deprecation-fRxUHoxv.js +0 -4
- package/dist/evidence/adapters/agent-eval.d.ts +0 -26
- package/dist/evidence/adapters/agent-eval.d.ts.map +0 -1
- package/dist/evidence/adapters/audit-script.d.ts +0 -25
- package/dist/evidence/adapters/audit-script.d.ts.map +0 -1
- package/dist/evidence/adapters/cargo-mutants.d.ts +0 -3
- package/dist/evidence/adapters/cargo-mutants.d.ts.map +0 -1
- package/dist/evidence/adapters/contract-conformance.d.ts +0 -16
- package/dist/evidence/adapters/contract-conformance.d.ts.map +0 -1
- package/dist/evidence/adapters/differential-report.d.ts +0 -18
- package/dist/evidence/adapters/differential-report.d.ts.map +0 -1
- package/dist/evidence/adapters/junit.d.ts +0 -17
- package/dist/evidence/adapters/junit.d.ts.map +0 -1
- package/dist/evidence/adapters/registry.d.ts +0 -63
- package/dist/evidence/adapters/registry.d.ts.map +0 -1
- package/dist/evidence/adapters/sarif.d.ts +0 -35
- package/dist/evidence/adapters/sarif.d.ts.map +0 -1
- package/dist/evidence/adapters/sbom.d.ts +0 -35
- package/dist/evidence/adapters/sbom.d.ts.map +0 -1
- package/dist/evidence/adapters/types.d.ts +0 -86
- package/dist/evidence/adapters/types.d.ts.map +0 -1
- package/dist/evidence/index.d.ts +0 -27
- package/dist/evidence/index.d.ts.map +0 -1
- package/dist/evidence/mock-inspection.d.ts +0 -16
- package/dist/evidence/mock-inspection.d.ts.map +0 -1
- package/dist/evidence/record.d.ts +0 -58
- package/dist/evidence/record.d.ts.map +0 -1
- package/dist/evidence/store.d.ts +0 -215
- package/dist/evidence/store.d.ts.map +0 -1
- package/dist/evidence/types.d.ts +0 -281
- package/dist/evidence/types.d.ts.map +0 -1
- package/dist/evidence-OyqpqHLS.js +0 -614
- package/dist/flow-command-CCRTE5Oe.js +0 -88
- package/dist/flow-command.d.ts +0 -25
- package/dist/flow-command.d.ts.map +0 -1
- package/dist/flows.d.ts +0 -7
- package/dist/flows.d.ts.map +0 -1
- package/dist/graph-analysis/analysis.d.ts +0 -106
- package/dist/graph-analysis/analysis.d.ts.map +0 -1
- package/dist/graph-analysis/index.d.ts +0 -6
- package/dist/graph-analysis/index.d.ts.map +0 -1
- package/dist/graph-analysis/input.d.ts +0 -33
- package/dist/graph-analysis/input.d.ts.map +0 -1
- package/dist/graph-analysis/load.d.ts +0 -21
- package/dist/graph-analysis/load.d.ts.map +0 -1
- package/dist/graph-analysis/render.d.ts +0 -4
- package/dist/graph-analysis/render.d.ts.map +0 -1
- package/dist/graph-analysis-IWaoJJSN.js +0 -657
- package/dist/hooks/command-not-found.d.ts +0 -23
- package/dist/hooks/command-not-found.d.ts.map +0 -1
- package/dist/hooks/command-not-found.js +0 -8
- package/dist/index.d.ts +0 -13
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js +0 -12
- package/dist/measurement/agent-eval-intervention.d.ts +0 -6
- package/dist/measurement/agent-eval-intervention.d.ts.map +0 -1
- package/dist/measurement/atomic-file.d.ts +0 -5
- package/dist/measurement/atomic-file.d.ts.map +0 -1
- package/dist/measurement/compare.d.ts +0 -4
- package/dist/measurement/compare.d.ts.map +0 -1
- package/dist/measurement/date-time.d.ts +0 -3
- package/dist/measurement/date-time.d.ts.map +0 -1
- package/dist/measurement/github-release-operational.d.ts +0 -7
- package/dist/measurement/github-release-operational.d.ts.map +0 -1
- package/dist/measurement/graph-adapters.d.ts +0 -304
- package/dist/measurement/graph-adapters.d.ts.map +0 -1
- package/dist/measurement/graph-portfolio-load.d.ts +0 -3
- package/dist/measurement/graph-portfolio-load.d.ts.map +0 -1
- package/dist/measurement/graph-portfolio.d.ts +0 -158
- package/dist/measurement/graph-portfolio.d.ts.map +0 -1
- package/dist/measurement/index.d.ts +0 -22
- package/dist/measurement/index.d.ts.map +0 -1
- package/dist/measurement/intervention-report.d.ts +0 -24
- package/dist/measurement/intervention-report.d.ts.map +0 -1
- package/dist/measurement/intervention-schema.d.ts +0 -144
- package/dist/measurement/intervention-schema.d.ts.map +0 -1
- package/dist/measurement/intervention-types.d.ts +0 -105
- package/dist/measurement/intervention-types.d.ts.map +0 -1
- package/dist/measurement/intervention.d.ts +0 -16
- package/dist/measurement/intervention.d.ts.map +0 -1
- package/dist/measurement/operational-report.d.ts +0 -17
- package/dist/measurement/operational-report.d.ts.map +0 -1
- package/dist/measurement/operational-schema.d.ts +0 -461
- package/dist/measurement/operational-schema.d.ts.map +0 -1
- package/dist/measurement/operational-types.d.ts +0 -121
- package/dist/measurement/operational-types.d.ts.map +0 -1
- package/dist/measurement/operational.d.ts +0 -13
- package/dist/measurement/operational.d.ts.map +0 -1
- package/dist/measurement/plans.d.ts +0 -6
- package/dist/measurement/plans.d.ts.map +0 -1
- package/dist/measurement/portfolio.d.ts +0 -54
- package/dist/measurement/portfolio.d.ts.map +0 -1
- package/dist/measurement/profiles.d.ts +0 -9
- package/dist/measurement/profiles.d.ts.map +0 -1
- package/dist/measurement/report.d.ts +0 -48
- package/dist/measurement/report.d.ts.map +0 -1
- package/dist/measurement/schemas/operational-evidence-v1.schema.json.d.ts +0 -384
- package/dist/measurement/store.d.ts +0 -14
- package/dist/measurement/store.d.ts.map +0 -1
- package/dist/measurement/types.d.ts +0 -85
- package/dist/measurement/types.d.ts.map +0 -1
- package/dist/measurement/validate.d.ts +0 -9
- package/dist/measurement/validate.d.ts.map +0 -1
- package/dist/measurement-j8sDSqx5.js +0 -2980
- package/dist/modules-DDQkKC4l.js +0 -23
- package/dist/modules.d.ts +0 -10
- package/dist/modules.d.ts.map +0 -1
- package/dist/org.d.ts +0 -61
- package/dist/org.d.ts.map +0 -1
- package/dist/plugins-CHpYhpEI.js +0 -77
- package/dist/plugins.d.ts +0 -13
- package/dist/plugins.d.ts.map +0 -1
- package/dist/quire/assurance.d.ts +0 -109
- package/dist/quire/assurance.d.ts.map +0 -1
- package/dist/quire/contract.d.ts +0 -88
- package/dist/quire/contract.d.ts.map +0 -1
- package/dist/quire/exec.d.ts +0 -66
- package/dist/quire/exec.d.ts.map +0 -1
- package/dist/quire/index.d.ts +0 -13
- package/dist/quire/index.d.ts.map +0 -1
- package/dist/quire/types.d.ts +0 -415
- package/dist/quire/types.d.ts.map +0 -1
- package/dist/quire/validate.d.ts +0 -39
- package/dist/quire/validate.d.ts.map +0 -1
- package/dist/quire-BsVj1xIR.js +0 -4968
- package/dist/schema-assets-HZWo_iFN.js +0 -233
- package/dist/schemas/assurance-v1.schema.json +0 -225
- package/dist/schemas/change-assurance-record-v1.schema.json +0 -234
- package/dist/schemas/coverage-v1.schema.json +0 -1111
- package/dist/schemas/operational-evidence-v1.schema.json +0 -381
- package/dist/schemas/proof-attestation-v1.schema.json +0 -96
- package/dist/schemas/properties-v1.schema.json +0 -159
- package/dist/schemas/verification-receipt-v1.schema.json +0 -208
- package/dist/validators/gates.d.ts +0 -18
- package/dist/validators/gates.d.ts.map +0 -1
- package/dist/validators/index.d.ts +0 -2
- package/dist/validators/index.d.ts.map +0 -1
- package/dist/version-CMxMIh5g.js +0 -17
- package/dist/version.d.ts +0 -3
- package/dist/version.d.ts.map +0 -1
- package/dist/write-CGTI0dRO.js +0 -157
- package/dist/write.d.ts +0 -28
- package/dist/write.d.ts.map +0 -1
- package/skills/assurance-status-report/SKILL.md +0 -135
- package/skills/assurance-status-report/references/report-contract.md +0 -110
- package/skills/gap-analysis/SKILL.md +0 -111
- package/skills/gap-analysis/references/step-1-target-selection.md +0 -53
- package/skills/gap-analysis/references/step-2-plan-completion.md +0 -49
- package/skills/gap-analysis/references/step-3-matrix-verification.md +0 -147
- package/skills/gap-analysis/references/step-4-underspecified-code.md +0 -92
- package/skills/gap-analysis/references/step-5-semantic-review.md +0 -51
- package/skills/gap-analysis/references/step-6-specreview-artifact.md +0 -108
- package/skills/spec-app-review/SKILL.md +0 -51
- package/skills/spec-app-review/references/checklist.md +0 -197
- package/skills/spec-architecture-evaluation/SKILL.md +0 -30
- package/skills/spec-correctness/SKILL.md +0 -96
- package/skills/spec-correctness/assets/strategy-table.md +0 -101
- package/skills/spec-correctness/assets/templates/fast-check.ts.md +0 -169
- package/skills/spec-correctness/assets/templates/hypothesis.py.md +0 -156
- package/skills/spec-correctness/assets/templates/proptest.rs.md +0 -147
- package/skills/spec-correctness/references/step-0-scope-and-harness.md +0 -94
- package/skills/spec-correctness/references/step-1-census.md +0 -53
- package/skills/spec-correctness/references/step-2-clause-grounding.md +0 -159
- package/skills/spec-correctness/references/step-3-strategy-selection.md +0 -85
- package/skills/spec-correctness/references/step-4-generate-tests.md +0 -117
- package/skills/spec-correctness/references/step-5-second-pass.md +0 -81
- package/skills/spec-correctness/references/step-6-review-artifact.md +0 -134
- package/skills/spec-correctness/references/step-7-report-and-handoff.md +0 -102
- package/skills/spec-dependency-analysis/SKILL.md +0 -90
- package/skills/spec-ears-analysis/SKILL.md +0 -102
- package/skills/spec-evidence-analysis/SKILL.md +0 -156
- package/skills/spec-failure-domain-analysis/SKILL.md +0 -59
- package/skills/spec-fuzz/SKILL.md +0 -133
- package/skills/spec-fuzz/assets/templates/atheris.py.md +0 -74
- package/skills/spec-fuzz/assets/templates/cargo-fuzz.rs.md +0 -83
- package/skills/spec-fuzz/assets/templates/fast-check.ts.md +0 -76
- package/skills/spec-fuzz/references/step-0-scope-and-harness.md +0 -51
- package/skills/spec-fuzz/references/step-1-select-obligations.md +0 -47
- package/skills/spec-fuzz/references/step-2-ground-entry-point.md +0 -55
- package/skills/spec-fuzz/references/step-3-emit-targets.md +0 -65
- package/skills/spec-fuzz/references/step-4-report.md +0 -56
- package/skills/spec-ideation/SKILL.md +0 -46
- package/skills/spec-integrity-analysis/SKILL.md +0 -62
- package/skills/spec-matrix/SKILL.md +0 -186
- package/skills/spec-matrix/assets/test-cases/TC-001.md +0 -35
- package/skills/spec-matrix/assets/test-cases/TC-002.md +0 -37
- package/skills/spec-matrix/assets/test-cases/TC-006.md +0 -50
- package/skills/spec-matrix/assets/test-matrix-example.md +0 -104
- package/skills/spec-matrix/assets/test-matrix-template.md +0 -123
- package/skills/spec-matrix/workflow-assets/dist/index.d.ts +0 -146
- package/skills/spec-matrix/workflow-assets/dist/index.d.ts.map +0 -1
- package/skills/spec-matrix/workflow-assets/dist/index.js +0 -7525
- package/skills/spec-matrix/workflow-assets/dist/invariants.d.ts +0 -6
- package/skills/spec-matrix/workflow-assets/dist/invariants.d.ts.map +0 -1
- package/skills/spec-matrix/workflow-assets/skills/matrix/SKILL.md +0 -35
- package/skills/spec-matrix/workflow-assets/skills/matrix/scripts/invariants.js +0 -1
- package/skills/spec-matrix/workflow-assets/skills/matrix/templates/report/default.md +0 -30
- package/skills/spec-matrix/workflow-assets/skills/matrix/workflows/matrix/def.yaml +0 -82
- package/skills/spec-object-review/SKILL.md +0 -125
- package/skills/spec-object-review/references/object-type-guide.md +0 -118
- package/skills/spec-review/SKILL.md +0 -92
- package/skills/spec-review/references/checklist.md +0 -50
- package/skills/spec-review/workflow-assets/dist/index.d.ts +0 -146
- package/skills/spec-review/workflow-assets/dist/index.d.ts.map +0 -1
- package/skills/spec-review/workflow-assets/dist/index.js +0 -7525
- package/skills/spec-review/workflow-assets/dist/invariants.d.ts +0 -6
- package/skills/spec-review/workflow-assets/dist/invariants.d.ts.map +0 -1
- package/skills/spec-review/workflow-assets/skills/review/SKILL.md +0 -96
- package/skills/spec-review/workflow-assets/skills/review/scripts/invariants.js +0 -61
- package/skills/spec-review/workflow-assets/skills/review/workflows/review/def.yaml +0 -68
- package/skills/spec-risk-complexity-analysis/SKILL.md +0 -92
- package/skills/spec-scope-boundary-analysis/SKILL.md +0 -101
- package/skills/spec-security-analysis/SKILL.md +0 -84
- package/skills/spec-security-analysis/assets/security-analysis-example.md +0 -89
- package/skills/spec-security-analysis/assets/security-analysis-template.md +0 -73
- package/skills/spec-security-analysis/references/component-type-mapping.md +0 -161
- package/skills/spec-security-analysis/references/gdpr/ChII-Principles.md +0 -58
- package/skills/spec-security-analysis/references/gdpr/ChIII-DataSubjectRights.md +0 -84
- package/skills/spec-security-analysis/references/gdpr/ChIV-ControllerProcessor.md +0 -83
- package/skills/spec-security-analysis/references/gdpr/ChV-DataTransfers.md +0 -62
- package/skills/spec-security-analysis/references/gdpr/index.md +0 -54
- package/skills/spec-security-analysis/references/iso27001/A5-OrganizationalControls.md +0 -64
- package/skills/spec-security-analysis/references/iso27001/A6-PeopleControls.md +0 -30
- package/skills/spec-security-analysis/references/iso27001/A7-PhysicalControls.md +0 -35
- package/skills/spec-security-analysis/references/iso27001/A8-TechnologicalControls.md +0 -66
- package/skills/spec-security-analysis/references/iso27001/index.md +0 -43
- package/skills/spec-security-analysis/references/nist-800-53/AC-AccessControl.md +0 -57
- package/skills/spec-security-analysis/references/nist-800-53/AU-AuditAccountability.md +0 -49
- package/skills/spec-security-analysis/references/nist-800-53/CM-ConfigurationManagement.md +0 -36
- package/skills/spec-security-analysis/references/nist-800-53/IA-IdentificationAuthentication.md +0 -44
- package/skills/spec-security-analysis/references/nist-800-53/SA-SystemServicesAcquisition.md +0 -50
- package/skills/spec-security-analysis/references/nist-800-53/SC-SystemCommunications.md +0 -53
- package/skills/spec-security-analysis/references/nist-800-53/SI-SystemInformationIntegrity.md +0 -52
- package/skills/spec-security-analysis/references/nist-800-53/index.md +0 -58
- package/skills/spec-security-analysis/references/owasp-asvs/V1-Architecture.md +0 -33
- package/skills/spec-security-analysis/references/owasp-asvs/V10-MaliciousCode.md +0 -33
- package/skills/spec-security-analysis/references/owasp-asvs/V11-BusinessLogic.md +0 -32
- package/skills/spec-security-analysis/references/owasp-asvs/V12-Files.md +0 -34
- package/skills/spec-security-analysis/references/owasp-asvs/V13-API.md +0 -34
- package/skills/spec-security-analysis/references/owasp-asvs/V14-Configuration.md +0 -35
- package/skills/spec-security-analysis/references/owasp-asvs/V2-Authentication.md +0 -36
- package/skills/spec-security-analysis/references/owasp-asvs/V3-SessionManagement.md +0 -35
- package/skills/spec-security-analysis/references/owasp-asvs/V4-AccessControl.md +0 -39
- package/skills/spec-security-analysis/references/owasp-asvs/V5-Validation.md +0 -37
- package/skills/spec-security-analysis/references/owasp-asvs/V6-Cryptography.md +0 -34
- package/skills/spec-security-analysis/references/owasp-asvs/V7-ErrorLogging.md +0 -37
- package/skills/spec-security-analysis/references/owasp-asvs/V8-DataProtection.md +0 -34
- package/skills/spec-security-analysis/references/owasp-asvs/V9-Communication.md +0 -32
- package/skills/spec-security-analysis/references/owasp-asvs/index.md +0 -59
- package/skills/spec-security-analysis/references/soc2/CC1-ControlEnvironment.md +0 -31
- package/skills/spec-security-analysis/references/soc2/CC2-CommunicationInformation.md +0 -27
- package/skills/spec-security-analysis/references/soc2/CC3-RiskAssessment.md +0 -29
- package/skills/spec-security-analysis/references/soc2/CC4-MonitoringActivities.md +0 -27
- package/skills/spec-security-analysis/references/soc2/CC5-ControlActivities.md +0 -28
- package/skills/spec-security-analysis/references/soc2/CC6-LogicalPhysicalAccess.md +0 -45
- package/skills/spec-security-analysis/references/soc2/CC7-SystemOperations.md +0 -42
- package/skills/spec-security-analysis/references/soc2/CC8-ChangeManagement.md +0 -32
- package/skills/spec-security-analysis/references/soc2/CC9-RiskMitigation.md +0 -34
- package/skills/spec-security-analysis/references/soc2/index.md +0 -46
- package/skills/spec-security-analysis/references/standards-index.md +0 -46
- package/skills/spec-to-plan/SKILL.md +0 -88
- package/skills/spec-to-plan/references/step-0-plan-selection.md +0 -121
- package/skills/spec-to-plan/references/step-1-analysis.md +0 -88
- package/skills/spec-to-plan/references/step-2-test-plan.md +0 -43
- package/skills/spec-to-plan/references/step-3-execution-plan.md +0 -218
- package/skills/spec-to-plan/workflow-assets/dist/index.d.ts +0 -146
- package/skills/spec-to-plan/workflow-assets/dist/index.d.ts.map +0 -1
- package/skills/spec-to-plan/workflow-assets/dist/index.js +0 -7525
- package/skills/spec-to-plan/workflow-assets/dist/invariants.d.ts +0 -6
- package/skills/spec-to-plan/workflow-assets/dist/invariants.d.ts.map +0 -1
- package/skills/spec-to-plan/workflow-assets/skills/to-plan/SKILL.md +0 -35
- package/skills/spec-to-plan/workflow-assets/skills/to-plan/scripts/invariants.js +0 -1
- package/skills/spec-to-plan/workflow-assets/skills/to-plan/templates/implementation-plan/default.md +0 -44
- package/skills/spec-to-plan/workflow-assets/skills/to-plan/workflows/to-plan/def.yaml +0 -85
- package/skills/specify/SKILL.md +0 -154
- package/skills/specify/assets/app-spec-template.md +0 -143
- package/skills/specify/assets/spec-template.md +0 -299
- package/skills/specify/references/integration-tests.md +0 -72
- package/skills/specify/references/us-to-fr.md +0 -40
- package/skills/specify/references/writing-good-requirements.md +0 -61
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
import { InvariantEvaluator } from '@agent-ix/workflow-core';
|
|
2
|
-
export declare const artifactFrontmatterValid: InvariantEvaluator;
|
|
3
|
-
export declare const artifactRelationshipsResolve: InvariantEvaluator;
|
|
4
|
-
export declare function clearProjectRegistryCache(): void;
|
|
5
|
-
export declare const specInvariants: Record<string, InvariantEvaluator>;
|
|
6
|
-
//# sourceMappingURL=invariants.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"invariants.d.ts","sourceRoot":"","sources":["../src/invariants.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAqDjC,eAAO,MAAM,wBAAwB,EAAE,kBAqHtC,CAAC;AAIF,eAAO,MAAM,4BAA4B,EAAE,kBAiG1C,CAAC;AA4DF,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAG7D,CAAC"}
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: spec-to-plan
|
|
3
|
-
description: Convert validated requirements into an implementation plan.
|
|
4
|
-
contributes:
|
|
5
|
-
workflows: ./workflows
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# /spec-to-plan
|
|
9
|
-
|
|
10
|
-
## When To Use
|
|
11
|
-
|
|
12
|
-
Use this skill when accepted requirements should become ordered implementation work.
|
|
13
|
-
|
|
14
|
-
## What It Does
|
|
15
|
-
|
|
16
|
-
Convert validated requirements into an implementation plan. The workflow definition is the source of truth for phases, gates, item schemas, recipes, and validation points.
|
|
17
|
-
|
|
18
|
-
## Workflow Behavior
|
|
19
|
-
|
|
20
|
-
- Start from the workflow status and follow reported next actions.
|
|
21
|
-
- Record evidence items before advancing analysis, review, or validation phases.
|
|
22
|
-
- Use recipes for deterministic command chains, but preserve human gates for acceptance.
|
|
23
|
-
- Prefer templates for stable artifact creation and generic file editing for broad semantic rewrites.
|
|
24
|
-
|
|
25
|
-
## Acceptance Criteria
|
|
26
|
-
|
|
27
|
-
- AC-1: Produces a plan that traces tasks back to requirement IDs.
|
|
28
|
-
- AC-2: Preserves dependencies, risks, and verification expectations in the plan.
|
|
29
|
-
- AC-3: Flags requirements that are not ready for planning instead of forcing tasks.
|
|
30
|
-
|
|
31
|
-
## Boundaries
|
|
32
|
-
|
|
33
|
-
- Do not silently overwrite existing human-authored requirements artifacts.
|
|
34
|
-
- Do not invent missing facts, links, or evidence; record assumptions and gaps.
|
|
35
|
-
- Do not expand to adjacent spec operations unless the user request requires it or the workflow directs it.
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export { specInvariants as invariants } from "../../../dist/index.js";
|
package/skills/spec-to-plan/workflow-assets/skills/to-plan/templates/implementation-plan/default.md
DELETED
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
type: Plan
|
|
3
|
-
id: "{{items.plan_answers.plan.id}}"
|
|
4
|
-
title: "{{items.plan_answers.plan.title}}"
|
|
5
|
-
status: active
|
|
6
|
-
traces_to:
|
|
7
|
-
- "{{items.plan_answers.plan.requirement_ids}}"
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# {{items.plan_answers.plan.id}}: {{items.plan_answers.plan.title}}
|
|
11
|
-
|
|
12
|
-
## Scope
|
|
13
|
-
|
|
14
|
-
This plan covers accepted requirements:
|
|
15
|
-
|
|
16
|
-
{{items.plan_answers.plan.requirement_ids}}
|
|
17
|
-
|
|
18
|
-
## Readiness Notes
|
|
19
|
-
|
|
20
|
-
{{items.plan_answers.plan.readiness_notes}}
|
|
21
|
-
|
|
22
|
-
## Work Breakdown
|
|
23
|
-
|
|
24
|
-
| Task | Requirement Trace | Outcome | Verification |
|
|
25
|
-
| ---- | ------------------------------------------- | ------------------------------ | ---------------------------------------------------- |
|
|
26
|
-
| T-1 | {{items.plan_answers.plan.requirement_ids}} | Define implementation changes. | Tests or review evidence linked to each requirement. |
|
|
27
|
-
| T-2 | {{items.plan_answers.plan.requirement_ids}} | Implement scoped changes. | Passing automated checks. |
|
|
28
|
-
| T-3 | {{items.plan_answers.plan.requirement_ids}} | Update verification evidence. | Requirements matrix or review report updated. |
|
|
29
|
-
|
|
30
|
-
## Dependencies
|
|
31
|
-
|
|
32
|
-
- Confirm every traced requirement is accepted and implementation-ready.
|
|
33
|
-
- Resolve readiness notes before scheduling blocked work.
|
|
34
|
-
|
|
35
|
-
## Risks
|
|
36
|
-
|
|
37
|
-
- Requirements with weak acceptance criteria may produce vague tasks.
|
|
38
|
-
- Missing trace evidence may cause implementation work to drift from the spec.
|
|
39
|
-
|
|
40
|
-
## Acceptance Criteria
|
|
41
|
-
|
|
42
|
-
- Every task traces to at least one requirement id.
|
|
43
|
-
- Every traced requirement has an implementation or verification task.
|
|
44
|
-
- Blockers are explicit and not hidden inside task descriptions.
|
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
name: to-plan
|
|
2
|
-
version: 0.1.0
|
|
3
|
-
description: Convert accepted requirements into a traced implementation plan.
|
|
4
|
-
initialPhase: intake
|
|
5
|
-
phases:
|
|
6
|
-
- { name: intake }
|
|
7
|
-
- { name: evidence_recorded }
|
|
8
|
-
- { name: plan_drafted }
|
|
9
|
-
- { name: validated }
|
|
10
|
-
- { name: accepted, terminal: true }
|
|
11
|
-
transitions:
|
|
12
|
-
- from: intake
|
|
13
|
-
to: evidence_recorded
|
|
14
|
-
invariants:
|
|
15
|
-
- "interview.complete:plan"
|
|
16
|
-
defaultGate: auto
|
|
17
|
-
- from: evidence_recorded
|
|
18
|
-
to: plan_drafted
|
|
19
|
-
invariants: []
|
|
20
|
-
defaultGate: auto
|
|
21
|
-
- from: plan_drafted
|
|
22
|
-
to: validated
|
|
23
|
-
invariants:
|
|
24
|
-
- "artifact.frontmatter_valid:implementation_plan"
|
|
25
|
-
defaultGate: auto
|
|
26
|
-
- from: validated
|
|
27
|
-
to: accepted
|
|
28
|
-
invariants: []
|
|
29
|
-
defaultGate: hitl
|
|
30
|
-
itemSchemas:
|
|
31
|
-
plan_answers: {}
|
|
32
|
-
ImplementationPlanSchema:
|
|
33
|
-
required: [type, id, title, traces_to]
|
|
34
|
-
properties:
|
|
35
|
-
type: { type: string }
|
|
36
|
-
id: { type: string }
|
|
37
|
-
title: { type: string }
|
|
38
|
-
traces_to: { type: array }
|
|
39
|
-
linkSchemas: {}
|
|
40
|
-
interviews:
|
|
41
|
-
plan:
|
|
42
|
-
itemType: plan_answers
|
|
43
|
-
completenessRule: all_required
|
|
44
|
-
questions:
|
|
45
|
-
- key: artifact_id
|
|
46
|
-
prompt: "Plan id, for example PLAN-001."
|
|
47
|
-
type: text
|
|
48
|
-
required: true
|
|
49
|
-
- key: slug
|
|
50
|
-
prompt: "Filename slug without the plan id."
|
|
51
|
-
type: text
|
|
52
|
-
required: true
|
|
53
|
-
- key: title
|
|
54
|
-
prompt: "Implementation plan title."
|
|
55
|
-
type: text
|
|
56
|
-
required: true
|
|
57
|
-
- key: requirement_ids
|
|
58
|
-
prompt: "Comma-separated accepted requirement ids this plan traces to."
|
|
59
|
-
type: text
|
|
60
|
-
required: true
|
|
61
|
-
- key: readiness_notes
|
|
62
|
-
prompt: "Known blockers, assumptions, or readiness notes."
|
|
63
|
-
type: text
|
|
64
|
-
required: true
|
|
65
|
-
artifactTemplates:
|
|
66
|
-
implementation_plan:
|
|
67
|
-
source: templates/implementation-plan/default.md
|
|
68
|
-
# Plan bundle layout: plan/<Plan-id>-<slug>/plan.md (index.md, log.md and the
|
|
69
|
-
# tasks/ Task files are authored by the skill's Step 0 / Step 3, which read the
|
|
70
|
-
# same plan_answers). This template drafts the bundle's plan.md shell.
|
|
71
|
-
target: plan/${items.plan_answers.plan.id}-${items.plan_answers.plan.slug}/plan.md
|
|
72
|
-
phase: plan_drafted
|
|
73
|
-
frontmatterSchema: ImplementationPlanSchema
|
|
74
|
-
recipes:
|
|
75
|
-
draft-and-validate:
|
|
76
|
-
description: Record planning inputs, draft the traced plan, validate it, then stop at acceptance.
|
|
77
|
-
steps:
|
|
78
|
-
- command: advance
|
|
79
|
-
to: evidence_recorded
|
|
80
|
-
- command: advance
|
|
81
|
-
to: plan_drafted
|
|
82
|
-
- command: advance
|
|
83
|
-
to: validated
|
|
84
|
-
- command: advance
|
|
85
|
-
to: accepted
|
package/skills/specify/SKILL.md
DELETED
|
@@ -1,154 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: specify
|
|
3
|
-
description: Create or update spec artifacts from a design or change request. Orchestrates authoring each requested requirement type (StR/US/FR/NFR/IT) as a discrete file using quoin catalog templates and Quire validation.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Specify
|
|
7
|
-
|
|
8
|
-
Use this skill when turning an agreed design, feature, or change request into
|
|
9
|
-
spec artifacts. `specify` decides **which artifacts the request needs**, authors
|
|
10
|
-
each one **as its own file** using the catalog templates, and validates.
|
|
11
|
-
|
|
12
|
-
## Scope to the request
|
|
13
|
-
|
|
14
|
-
Author **only the artifact types the request calls for** — nothing more.
|
|
15
|
-
|
|
16
|
-
- "Add a user story for X" → one US.
|
|
17
|
-
- "Add the FR that implements US-003" → one FR (traced to US-003).
|
|
18
|
-
- "Add a user story and the requirement that implements it" → one US **and** one FR.
|
|
19
|
-
- "Edit FR-002 to …" → edit that one FR file in place.
|
|
20
|
-
- "Start a spec for service X" / "backport a spec from this code" → the full
|
|
21
|
-
chain (`spec.md` + US + FR + NFR, and IT where there are external integrations).
|
|
22
|
-
|
|
23
|
-
When unsure which types a request implies, decide from the request and state what
|
|
24
|
-
you are creating. A backport or new feature almost always needs **FR artifacts**,
|
|
25
|
-
not just a summary.
|
|
26
|
-
|
|
27
|
-
## Requirements are files, not table rows
|
|
28
|
-
|
|
29
|
-
Each requirement is a **discrete artifact file** with `type:` frontmatter. The
|
|
30
|
-
Requirements table inside `spec.md` (master-requirements) is an **index/summary**
|
|
31
|
-
— it never replaces the artifacts. Author every requested requirement as its own
|
|
32
|
-
file under the matching directory:
|
|
33
|
-
|
|
34
|
-
| Type | `type:` | Location |
|
|
35
|
-
| ---- | ------- | ------------------------------ |
|
|
36
|
-
| StR | `StR` | `spec/stakeholder/StR-XXX-*.md`|
|
|
37
|
-
| US | `US` | `spec/usecase/US-XXX-*.md` |
|
|
38
|
-
| FR | `FR` | `spec/functional/FR-XXX-*.md` |
|
|
39
|
-
| NFR | `NFR` | `spec/non-functional/NFR-XXX-*.md` |
|
|
40
|
-
| IT | `IT` | `spec/integration/IT-XXX-*.md` |
|
|
41
|
-
|
|
42
|
-
> If a request asks for functional requirements and you produced only table rows
|
|
43
|
-
> in `spec.md`, the request is **not done** — create the `FR-XXX.md` files.
|
|
44
|
-
|
|
45
|
-
## Writing good requirements
|
|
46
|
-
|
|
47
|
-
The templates and Quire enforce *shape*; you supply the *judgment*. Author it well
|
|
48
|
-
here so `spec-review` has less to send back. Three principles — full guidance with
|
|
49
|
-
examples in [references/writing-good-requirements.md](references/writing-good-requirements.md):
|
|
50
|
-
|
|
51
|
-
- **Scope: tight beats broad.** Prefer a narrow spec that fully defines its slice over
|
|
52
|
-
a sprawling, vague one. Treat `spec.md` §2.2 Out of Scope as first-class — decide
|
|
53
|
-
your non-goals deliberately; an empty Out-of-Scope is a smell.
|
|
54
|
-
- **User stories: INVEST + no solution-prescribing.** Describe the user need with a
|
|
55
|
-
real "so that …"; let the FRs pick the mechanism.
|
|
56
|
-
- **Acceptance criteria: cover the unhappy paths, be concrete.** Author happy/error/edge
|
|
57
|
-
and negative cases up front, in measurable terms ("returns HTTP 422 within 200ms",
|
|
58
|
-
not "handles errors gracefully").
|
|
59
|
-
|
|
60
|
-
## Process
|
|
61
|
-
|
|
62
|
-
Run only the steps the request needs; stop after IT.
|
|
63
|
-
|
|
64
|
-
1. Identify the repository that owns the spec files, and which artifact types the
|
|
65
|
-
request implies (any subset of StR, US, FR, NFR, IT).
|
|
66
|
-
2. Run `quoin write <repo_dir> --types <type[,type...]>` **once** for the full
|
|
67
|
-
set. Use the returned skeletons, schemas, module roots, and examples as the
|
|
68
|
-
authoring contract — the per-type rules live in the template, not your memory.
|
|
69
|
-
The pack also reports the repo's `Org:`; use that value for the `org:` field
|
|
70
|
-
and for the `ix://<org>/<repo>/…` targets you write. If it reports
|
|
71
|
-
`Org: unresolved`, ask the user which organization owns the repo — never
|
|
72
|
-
invent one, never leave a literal `<your-org>` in a file, and never copy the
|
|
73
|
-
org out of a skeleton's example values.
|
|
74
|
-
3. Author each artifact as its own file (table above), in this logical order,
|
|
75
|
-
skipping any type not requested:
|
|
76
|
-
- `spec.md` — **REQUIRED when starting a new spec**: the
|
|
77
|
-
`type: master-requirements` root/index at `spec/spec.md`, authored from
|
|
78
|
-
`assets/spec-template.md` (or `assets/app-spec-template.md` for an
|
|
79
|
-
application); keep scope tight and fill Out of Scope deliberately
|
|
80
|
-
(see [references/writing-good-requirements.md](references/writing-good-requirements.md)).
|
|
81
|
-
Then → StR → US (INVEST, no solution-prescribing — same reference) →
|
|
82
|
-
**derive FR from US** (see [references/us-to-fr.md](references/us-to-fr.md))
|
|
83
|
-
→ FR (cover unhappy paths, measurable ACs — same reference)
|
|
84
|
-
→ NFR → IT (see [references/integration-tests.md](references/integration-tests.md)).
|
|
85
|
-
4. Keep traceability in frontmatter `relationships:` (e.g. a US `traces_to` its
|
|
86
|
-
FRs; an FR/NFR/IT links back to the US/FR it serves).
|
|
87
|
-
5. Run `quire validate <glob> [glob2 ...]` over the changed spec scope and fix
|
|
88
|
-
every error before continuing.
|
|
89
|
-
6. **Open in the review cockpit.** After validation passes, run
|
|
90
|
-
`filament open <primary-artifact>` to open the authored artifact in the running
|
|
91
|
-
filament-ide cockpit (it fires the `filament-ide://` deep link and prints a
|
|
92
|
-
clickable link as a fallback). Use the main artifact you created — the
|
|
93
|
-
new/edited `FR-XXX.md`, or `spec/spec.md` when starting a spec. Skip silently if
|
|
94
|
-
the `filament` command is not installed.
|
|
95
|
-
7. **Stop at IT.** Then ask the user whether to build the test matrix
|
|
96
|
-
(`spec-matrix`) and run review (`spec-review`) — unless they already requested
|
|
97
|
-
them. Only run those on confirmation.
|
|
98
|
-
|
|
99
|
-
## Functional requirements
|
|
100
|
-
|
|
101
|
-
FRs are normative (`SHALL` / `SHALL NOT`), atomic, and independently verifiable,
|
|
102
|
-
each with an Acceptance Criteria table (the `fr.md` skeleton enforces the shape).
|
|
103
|
-
|
|
104
|
-
- Derive FRs from the driving user story — see
|
|
105
|
-
[references/us-to-fr.md](references/us-to-fr.md).
|
|
106
|
-
- Make the ACs count: cover happy/error/edge and negative cases in concrete,
|
|
107
|
-
measurable terms — see
|
|
108
|
-
[references/writing-good-requirements.md](references/writing-good-requirements.md).
|
|
109
|
-
- A behavioral FR has no `object:` field. A **domain-typed** FR carries
|
|
110
|
-
`object: <type>` (e.g. `entity`, `event`, `api_endpoint`, `process`,
|
|
111
|
-
`configuration`) and uses that type's structural template. Look up the
|
|
112
|
-
type→template map and relationship verbs in
|
|
113
|
-
`spec-object-review`'s `references/object-type-guide.md`, and inspect a type
|
|
114
|
-
with `quoin catalog show <type>`.
|
|
115
|
-
|
|
116
|
-
## Application specs
|
|
117
|
-
|
|
118
|
-
When `component_type: application`, initialize `spec.md` from
|
|
119
|
-
`assets/app-spec-template.md`. Application specs own **only cross-service
|
|
120
|
-
concerns** — architecture rationale (ADRs), cross-service sequence diagrams,
|
|
121
|
-
system-level NFRs, the external consumer contract, scope boundaries, security
|
|
122
|
-
model. Per-service detail (endpoint contracts, DB schemas, per-service NFRs)
|
|
123
|
-
stays in the individual service specs. Otherwise use `assets/spec-template.md`.
|
|
124
|
-
|
|
125
|
-
## Authoring rules
|
|
126
|
-
|
|
127
|
-
- Let frontmatter identify each file. The discriminator is `type` (e.g.
|
|
128
|
-
`type: FR`, `type: master-requirements`) — it names the archetype.
|
|
129
|
-
- Use catalog skeletons and schemas rather than memory.
|
|
130
|
-
- Keep workflow definitions out of artifact/object type vocabularies.
|
|
131
|
-
- Validate every created or edited artifact with Quire before finishing.
|
|
132
|
-
|
|
133
|
-
## Reserved OKF Files
|
|
134
|
-
|
|
135
|
-
`spec-artifacts-iso` ships two reserved archetypes for the OKF folder structure;
|
|
136
|
-
author them like any other type:
|
|
137
|
-
|
|
138
|
-
- `index.md` — `type: index`, body is a `## Contents` link list pointing at the
|
|
139
|
-
artifacts in the folder.
|
|
140
|
-
- `log.md` — `type: log`, body is a `## History` of changes to the folder's specs.
|
|
141
|
-
|
|
142
|
-
## Common Spec Layout
|
|
143
|
-
|
|
144
|
-
```text
|
|
145
|
-
spec/
|
|
146
|
-
├── spec.md
|
|
147
|
-
├── stakeholder/ # StR-XXX
|
|
148
|
-
├── usecase/ # US-XXX
|
|
149
|
-
├── functional/ # FR-XXX
|
|
150
|
-
├── non-functional/ # NFR-XXX
|
|
151
|
-
├── integration/ # IT-XXX
|
|
152
|
-
├── matrix/
|
|
153
|
-
└── analysis/
|
|
154
|
-
```
|
|
@@ -1,143 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
type: master-requirements
|
|
3
|
-
name: <app-name>
|
|
4
|
-
org: <your-org> # use the `Org:` quoin write reports
|
|
5
|
-
component_type: application
|
|
6
|
-
tags: []
|
|
7
|
-
implementation_language: null
|
|
8
|
-
depends_on:
|
|
9
|
-
# List all component repos this application owns
|
|
10
|
-
# - service-one
|
|
11
|
-
# - library-one
|
|
12
|
-
standards_alignment:
|
|
13
|
-
- iso-iec-ieee-29148
|
|
14
|
-
security_critical: false
|
|
15
|
-
---
|
|
16
|
-
# Master Requirements Specification
|
|
17
|
-
## <App Name>
|
|
18
|
-
|
|
19
|
-
### 1. Purpose
|
|
20
|
-
|
|
21
|
-
<!-- 2-3 sentences: What problem does this application solve? Who does it serve?
|
|
22
|
-
Be specific — avoid restating the component names. -->
|
|
23
|
-
|
|
24
|
-
### 2. Scope
|
|
25
|
-
|
|
26
|
-
This specification defines the **application-level** domain, encompassing end-to-end processes that span multiple component repositories. Individual component behavior is specified in each component's own `spec/` directory; this document defines how they compose into a complete system.
|
|
27
|
-
|
|
28
|
-
### 3. System Overview
|
|
29
|
-
|
|
30
|
-
#### 3.1 Component Registry
|
|
31
|
-
|
|
32
|
-
<!-- One row per component repo. Distinguish services vs libraries. -->
|
|
33
|
-
|
|
34
|
-
| Component | Type | Repo | Role |
|
|
35
|
-
|-----------|------|------|------|
|
|
36
|
-
| <!-- name --> | <!-- fastapi-service / python-lib / react-lib / etc --> | `<!-- repo-name -->` | <!-- What it does in 1 sentence --> |
|
|
37
|
-
|
|
38
|
-
#### 3.2 Dependency Graph
|
|
39
|
-
|
|
40
|
-
<!-- Required: Show how components connect. Use color styles to distinguish
|
|
41
|
-
services (red), libraries (green), SDKs (orange), UI (purple). -->
|
|
42
|
-
|
|
43
|
-
```mermaid
|
|
44
|
-
graph TD
|
|
45
|
-
A[ComponentA] --> B[ComponentB]
|
|
46
|
-
|
|
47
|
-
style A fill:#e74c3c,color:#fff
|
|
48
|
-
style B fill:#2ecc71,color:#fff
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
### 4. Architecture Rationale
|
|
52
|
-
|
|
53
|
-
<!-- Required: Explain WHY the architecture looks the way it does.
|
|
54
|
-
One ADR entry per major structural decision. -->
|
|
55
|
-
|
|
56
|
-
#### ADR-001: <!-- Decision Title -->
|
|
57
|
-
|
|
58
|
-
**Decision**: <!-- What was decided. One sentence. -->
|
|
59
|
-
|
|
60
|
-
**Rationale**: <!-- Why? What problem does this solve? -->
|
|
61
|
-
|
|
62
|
-
**Alternatives considered**: <!-- What else was evaluated and why it was rejected. -->
|
|
63
|
-
|
|
64
|
-
### 5. Stakeholder Requirements
|
|
65
|
-
|
|
66
|
-
| ID | Title | Artifact |
|
|
67
|
-
|----|-------|----------|
|
|
68
|
-
| StR-001 | <!-- Title --> | [StR-001](stakeholder/StR-001-<slug>.md) |
|
|
69
|
-
|
|
70
|
-
### 6. User Stories
|
|
71
|
-
|
|
72
|
-
| ID | Title | Role | Artifact |
|
|
73
|
-
|----|-------|------|----------|
|
|
74
|
-
| US-001 | <!-- Title --> | <!-- Role --> | [US-001](usecase/US-001-<slug>.md) |
|
|
75
|
-
|
|
76
|
-
### 7. Functional Requirements
|
|
77
|
-
|
|
78
|
-
<!-- Application specs MUST include these object types:
|
|
79
|
-
- domain: Bounded context, ER diagram (FR-001)
|
|
80
|
-
- process: One per major cross-service workflow
|
|
81
|
-
- configuration: Shared config across services
|
|
82
|
-
- integration: Consumer contract (how to integrate with this app) -->
|
|
83
|
-
|
|
84
|
-
| ID | Title | Object Type | Artifact |
|
|
85
|
-
|----|-------|-------------|----------|
|
|
86
|
-
| FR-001 | <!-- App --> Domain | domain | [FR-001](functional/FR-001-<slug>-domain.md) |
|
|
87
|
-
| FR-002 | <!-- Primary Workflow --> Process | process | [FR-002](functional/FR-002-<slug>-process.md) |
|
|
88
|
-
| FR-XXX | <!-- App --> Configuration | configuration | [FR-XXX](functional/FR-XXX-configuration.md) |
|
|
89
|
-
| FR-XXX | Consumer Integration Contract | integration | [FR-XXX](functional/FR-XXX-consumer-integration.md) |
|
|
90
|
-
|
|
91
|
-
### 8. Non-Functional Requirements
|
|
92
|
-
|
|
93
|
-
<!-- Application specs MUST include these three NFRs:
|
|
94
|
-
- Security Constraints (crypto, transport, error handling)
|
|
95
|
-
- System Reliability (SLA, p99 latency, scale limits, RTO/RPO)
|
|
96
|
-
- Deployment Topology (namespace, ingress, discovery, secrets) -->
|
|
97
|
-
|
|
98
|
-
| ID | Title | Artifact |
|
|
99
|
-
|----|-------|----------|
|
|
100
|
-
| NFR-001 | Security Constraints | [NFR-001](non-functional/NFR-001-security.md) |
|
|
101
|
-
| NFR-002 | System Reliability | [NFR-002](non-functional/NFR-002-reliability.md) |
|
|
102
|
-
| NFR-003 | Deployment Topology | [NFR-003](non-functional/NFR-003-deployment.md) |
|
|
103
|
-
|
|
104
|
-
### 9. Domain Model
|
|
105
|
-
|
|
106
|
-
See [FR-001 <!-- App --> Domain](functional/FR-001-<slug>-domain.md) for the bounded context definition, entity relationships, and ER diagram.
|
|
107
|
-
|
|
108
|
-
### 10. Scope Boundaries
|
|
109
|
-
|
|
110
|
-
<!-- Required: Explicitly list what this application does NOT do.
|
|
111
|
-
These are deliberate exclusions, not future work. -->
|
|
112
|
-
|
|
113
|
-
| Out of Scope | Rationale |
|
|
114
|
-
|---|---|
|
|
115
|
-
| <!-- Feature --> | <!-- Why deliberately excluded --> |
|
|
116
|
-
|
|
117
|
-
### 11. Security Model
|
|
118
|
-
|
|
119
|
-
<!-- Required: Define the actor model and trust hierarchy.
|
|
120
|
-
What roles exist? What can each role do? -->
|
|
121
|
-
|
|
122
|
-
#### Actor Roles
|
|
123
|
-
|
|
124
|
-
| Role | Description | Assigned By |
|
|
125
|
-
|------|-------------|-------------|
|
|
126
|
-
| `anonymous` | Unauthenticated caller | Default |
|
|
127
|
-
| `user` | Authenticated user | Auth system |
|
|
128
|
-
| `admin` | Administrator | Operator |
|
|
129
|
-
| `operator` | Infrastructure operator | Out-of-band |
|
|
130
|
-
|
|
131
|
-
#### Trust Boundaries
|
|
132
|
-
|
|
133
|
-
<!-- List capabilities and which roles can exercise them. -->
|
|
134
|
-
|
|
135
|
-
| Capability | anonymous | user | admin | operator |
|
|
136
|
-
|---|---|---|---|---|
|
|
137
|
-
| <!-- action --> | — | ✅ | ✅ | ✅ |
|
|
138
|
-
|
|
139
|
-
### 12. References
|
|
140
|
-
|
|
141
|
-
| Standard | Description |
|
|
142
|
-
|----------|-------------|
|
|
143
|
-
| ISO/IEC/IEEE 29148 | Requirements engineering standard |
|