@agent-ix/quoin 0.1.3

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 (215) hide show
  1. package/.agents/plugins/marketplace.json +14 -0
  2. package/.claude-plugin/marketplace.json +16 -0
  3. package/.claude-plugin/plugin.json +8 -0
  4. package/.codex-plugin/plugin.json +27 -0
  5. package/.github/plugin/marketplace.json +16 -0
  6. package/LICENSE +21 -0
  7. package/README.md +266 -0
  8. package/bin/quoin.js +14 -0
  9. package/default-modules.yaml +82 -0
  10. package/dist/base-DrUMkAh1.js +137 -0
  11. package/dist/base.d.ts +23 -0
  12. package/dist/base.d.ts.map +1 -0
  13. package/dist/catalog.d.ts +32 -0
  14. package/dist/catalog.d.ts.map +1 -0
  15. package/dist/cli.d.ts +18 -0
  16. package/dist/cli.d.ts.map +1 -0
  17. package/dist/cli.js +20 -0
  18. package/dist/commands/catalog/index.d.ts +2 -0
  19. package/dist/commands/catalog/index.d.ts.map +1 -0
  20. package/dist/commands/catalog/index.js +2 -0
  21. package/dist/commands/catalog/list.d.ts +11 -0
  22. package/dist/commands/catalog/list.d.ts.map +1 -0
  23. package/dist/commands/catalog/list.js +22 -0
  24. package/dist/commands/catalog/show.d.ts +13 -0
  25. package/dist/commands/catalog/show.d.ts.map +1 -0
  26. package/dist/commands/catalog/show.js +25 -0
  27. package/dist/commands/catalog/validate.d.ts +10 -0
  28. package/dist/commands/catalog/validate.d.ts.map +1 -0
  29. package/dist/commands/catalog/validate.js +27 -0
  30. package/dist/commands/config/doctor.d.ts +7 -0
  31. package/dist/commands/config/doctor.d.ts.map +1 -0
  32. package/dist/commands/config/doctor.js +15 -0
  33. package/dist/commands/config/edit.d.ts +7 -0
  34. package/dist/commands/config/edit.d.ts.map +1 -0
  35. package/dist/commands/config/edit.js +13 -0
  36. package/dist/commands/config/get.d.ts +11 -0
  37. package/dist/commands/config/get.d.ts.map +1 -0
  38. package/dist/commands/config/get.js +20 -0
  39. package/dist/commands/config/index.d.ts +2 -0
  40. package/dist/commands/config/index.d.ts.map +1 -0
  41. package/dist/commands/config/index.js +2 -0
  42. package/dist/commands/config/set.d.ts +12 -0
  43. package/dist/commands/config/set.d.ts.map +1 -0
  44. package/dist/commands/config/set.js +26 -0
  45. package/dist/commands/matrix.d.ts +14 -0
  46. package/dist/commands/matrix.d.ts.map +1 -0
  47. package/dist/commands/matrix.js +15 -0
  48. package/dist/commands/module/ensure-defaults.d.ts +8 -0
  49. package/dist/commands/module/ensure-defaults.d.ts.map +1 -0
  50. package/dist/commands/module/ensure-defaults.js +17 -0
  51. package/dist/commands/module/index.d.ts +2 -0
  52. package/dist/commands/module/index.d.ts.map +1 -0
  53. package/dist/commands/module/index.js +2 -0
  54. package/dist/commands/module/install.d.ts +11 -0
  55. package/dist/commands/module/install.d.ts.map +1 -0
  56. package/dist/commands/module/install.js +22 -0
  57. package/dist/commands/module/list.d.ts +8 -0
  58. package/dist/commands/module/list.d.ts.map +1 -0
  59. package/dist/commands/module/list.js +13 -0
  60. package/dist/commands/module/remove.d.ts +10 -0
  61. package/dist/commands/module/remove.d.ts.map +1 -0
  62. package/dist/commands/module/remove.js +16 -0
  63. package/dist/commands/plugin/deprecation.d.ts +10 -0
  64. package/dist/commands/plugin/deprecation.d.ts.map +1 -0
  65. package/dist/commands/plugin/ensure-defaults.d.ts +8 -0
  66. package/dist/commands/plugin/ensure-defaults.d.ts.map +1 -0
  67. package/dist/commands/plugin/ensure-defaults.js +12 -0
  68. package/dist/commands/plugin/index.d.ts +2 -0
  69. package/dist/commands/plugin/index.d.ts.map +1 -0
  70. package/dist/commands/plugin/index.js +2 -0
  71. package/dist/commands/plugin/install.d.ts +8 -0
  72. package/dist/commands/plugin/install.d.ts.map +1 -0
  73. package/dist/commands/plugin/install.js +12 -0
  74. package/dist/commands/plugin/list.d.ts +8 -0
  75. package/dist/commands/plugin/list.d.ts.map +1 -0
  76. package/dist/commands/plugin/list.js +12 -0
  77. package/dist/commands/plugin/remove.d.ts +8 -0
  78. package/dist/commands/plugin/remove.d.ts.map +1 -0
  79. package/dist/commands/plugin/remove.js +12 -0
  80. package/dist/commands/review.d.ts +14 -0
  81. package/dist/commands/review.d.ts.map +1 -0
  82. package/dist/commands/review.js +15 -0
  83. package/dist/commands/to-plan.d.ts +14 -0
  84. package/dist/commands/to-plan.d.ts.map +1 -0
  85. package/dist/commands/to-plan.js +15 -0
  86. package/dist/commands/update.d.ts +13 -0
  87. package/dist/commands/update.d.ts.map +1 -0
  88. package/dist/commands/update.js +34 -0
  89. package/dist/commands/write.d.ts +16 -0
  90. package/dist/commands/write.d.ts.map +1 -0
  91. package/dist/commands/write.js +33 -0
  92. package/dist/config-schema-Dp-vlxuR.js +13 -0
  93. package/dist/config-schema.d.ts +52 -0
  94. package/dist/config-schema.d.ts.map +1 -0
  95. package/dist/deprecation-fRxUHoxv.js +4 -0
  96. package/dist/flow-command-SMjCSOFg.js +88 -0
  97. package/dist/flow-command.d.ts +25 -0
  98. package/dist/flow-command.d.ts.map +1 -0
  99. package/dist/flows.d.ts +7 -0
  100. package/dist/flows.d.ts.map +1 -0
  101. package/dist/index.d.ts +11 -0
  102. package/dist/index.d.ts.map +1 -0
  103. package/dist/index.js +9 -0
  104. package/dist/modules-CW8pBK41.js +22 -0
  105. package/dist/modules.d.ts +10 -0
  106. package/dist/modules.d.ts.map +1 -0
  107. package/dist/org.d.ts +61 -0
  108. package/dist/org.d.ts.map +1 -0
  109. package/dist/plugins-GSxafyD3.js +77 -0
  110. package/dist/plugins.d.ts +13 -0
  111. package/dist/plugins.d.ts.map +1 -0
  112. package/dist/version-_1nY4KyJ.js +17 -0
  113. package/dist/version.d.ts +3 -0
  114. package/dist/version.d.ts.map +1 -0
  115. package/dist/write-CQAitcI5.js +156 -0
  116. package/dist/write.d.ts +28 -0
  117. package/dist/write.d.ts.map +1 -0
  118. package/package.json +119 -0
  119. package/skills/gap-analysis/SKILL.md +97 -0
  120. package/skills/gap-analysis/references/step-1-target-selection.md +53 -0
  121. package/skills/gap-analysis/references/step-2-plan-completion.md +49 -0
  122. package/skills/gap-analysis/references/step-3-matrix-verification.md +54 -0
  123. package/skills/gap-analysis/references/step-4-underspecified-code.md +63 -0
  124. package/skills/gap-analysis/references/step-5-semantic-review.md +51 -0
  125. package/skills/gap-analysis/references/step-6-specreview-artifact.md +95 -0
  126. package/skills/spec-app-review/SKILL.md +51 -0
  127. package/skills/spec-app-review/references/checklist.md +197 -0
  128. package/skills/spec-dependency-analysis/SKILL.md +75 -0
  129. package/skills/spec-ears-analysis/SKILL.md +89 -0
  130. package/skills/spec-evidence-analysis/SKILL.md +78 -0
  131. package/skills/spec-failure-domain-analysis/SKILL.md +44 -0
  132. package/skills/spec-ideation/SKILL.md +46 -0
  133. package/skills/spec-integrity-analysis/SKILL.md +47 -0
  134. package/skills/spec-matrix/SKILL.md +168 -0
  135. package/skills/spec-matrix/assets/test-cases/TC-001.md +35 -0
  136. package/skills/spec-matrix/assets/test-cases/TC-002.md +37 -0
  137. package/skills/spec-matrix/assets/test-cases/TC-006.md +50 -0
  138. package/skills/spec-matrix/assets/test-matrix-example.md +104 -0
  139. package/skills/spec-matrix/assets/test-matrix-template.md +123 -0
  140. package/skills/spec-matrix/workflow-assets/skills/matrix/SKILL.md +35 -0
  141. package/skills/spec-matrix/workflow-assets/skills/matrix/scripts/invariants.js +1 -0
  142. package/skills/spec-matrix/workflow-assets/skills/matrix/templates/report/default.md +30 -0
  143. package/skills/spec-matrix/workflow-assets/skills/matrix/workflows/matrix/def.yaml +82 -0
  144. package/skills/spec-object-review/SKILL.md +125 -0
  145. package/skills/spec-object-review/references/object-type-guide.md +118 -0
  146. package/skills/spec-review/SKILL.md +71 -0
  147. package/skills/spec-review/references/checklist.md +50 -0
  148. package/skills/spec-review/workflow-assets/skills/review/SKILL.md +96 -0
  149. package/skills/spec-review/workflow-assets/skills/review/scripts/invariants.js +60 -0
  150. package/skills/spec-review/workflow-assets/skills/review/workflows/review/def.yaml +68 -0
  151. package/skills/spec-risk-complexity-analysis/SKILL.md +77 -0
  152. package/skills/spec-scope-boundary-analysis/SKILL.md +86 -0
  153. package/skills/spec-security-analysis/SKILL.md +84 -0
  154. package/skills/spec-security-analysis/assets/security-analysis-example.md +89 -0
  155. package/skills/spec-security-analysis/assets/security-analysis-template.md +73 -0
  156. package/skills/spec-security-analysis/references/component-type-mapping.md +161 -0
  157. package/skills/spec-security-analysis/references/gdpr/ChII-Principles.md +58 -0
  158. package/skills/spec-security-analysis/references/gdpr/ChIII-DataSubjectRights.md +84 -0
  159. package/skills/spec-security-analysis/references/gdpr/ChIV-ControllerProcessor.md +83 -0
  160. package/skills/spec-security-analysis/references/gdpr/ChV-DataTransfers.md +62 -0
  161. package/skills/spec-security-analysis/references/gdpr/index.md +54 -0
  162. package/skills/spec-security-analysis/references/iso27001/A5-OrganizationalControls.md +64 -0
  163. package/skills/spec-security-analysis/references/iso27001/A6-PeopleControls.md +30 -0
  164. package/skills/spec-security-analysis/references/iso27001/A7-PhysicalControls.md +35 -0
  165. package/skills/spec-security-analysis/references/iso27001/A8-TechnologicalControls.md +66 -0
  166. package/skills/spec-security-analysis/references/iso27001/index.md +43 -0
  167. package/skills/spec-security-analysis/references/nist-800-53/AC-AccessControl.md +57 -0
  168. package/skills/spec-security-analysis/references/nist-800-53/AU-AuditAccountability.md +49 -0
  169. package/skills/spec-security-analysis/references/nist-800-53/CM-ConfigurationManagement.md +36 -0
  170. package/skills/spec-security-analysis/references/nist-800-53/IA-IdentificationAuthentication.md +44 -0
  171. package/skills/spec-security-analysis/references/nist-800-53/SA-SystemServicesAcquisition.md +50 -0
  172. package/skills/spec-security-analysis/references/nist-800-53/SC-SystemCommunications.md +53 -0
  173. package/skills/spec-security-analysis/references/nist-800-53/SI-SystemInformationIntegrity.md +52 -0
  174. package/skills/spec-security-analysis/references/nist-800-53/index.md +58 -0
  175. package/skills/spec-security-analysis/references/owasp-asvs/V1-Architecture.md +33 -0
  176. package/skills/spec-security-analysis/references/owasp-asvs/V10-MaliciousCode.md +33 -0
  177. package/skills/spec-security-analysis/references/owasp-asvs/V11-BusinessLogic.md +32 -0
  178. package/skills/spec-security-analysis/references/owasp-asvs/V12-Files.md +34 -0
  179. package/skills/spec-security-analysis/references/owasp-asvs/V13-API.md +34 -0
  180. package/skills/spec-security-analysis/references/owasp-asvs/V14-Configuration.md +35 -0
  181. package/skills/spec-security-analysis/references/owasp-asvs/V2-Authentication.md +36 -0
  182. package/skills/spec-security-analysis/references/owasp-asvs/V3-SessionManagement.md +35 -0
  183. package/skills/spec-security-analysis/references/owasp-asvs/V4-AccessControl.md +39 -0
  184. package/skills/spec-security-analysis/references/owasp-asvs/V5-Validation.md +37 -0
  185. package/skills/spec-security-analysis/references/owasp-asvs/V6-Cryptography.md +34 -0
  186. package/skills/spec-security-analysis/references/owasp-asvs/V7-ErrorLogging.md +37 -0
  187. package/skills/spec-security-analysis/references/owasp-asvs/V8-DataProtection.md +34 -0
  188. package/skills/spec-security-analysis/references/owasp-asvs/V9-Communication.md +32 -0
  189. package/skills/spec-security-analysis/references/owasp-asvs/index.md +59 -0
  190. package/skills/spec-security-analysis/references/soc2/CC1-ControlEnvironment.md +31 -0
  191. package/skills/spec-security-analysis/references/soc2/CC2-CommunicationInformation.md +27 -0
  192. package/skills/spec-security-analysis/references/soc2/CC3-RiskAssessment.md +29 -0
  193. package/skills/spec-security-analysis/references/soc2/CC4-MonitoringActivities.md +27 -0
  194. package/skills/spec-security-analysis/references/soc2/CC5-ControlActivities.md +28 -0
  195. package/skills/spec-security-analysis/references/soc2/CC6-LogicalPhysicalAccess.md +45 -0
  196. package/skills/spec-security-analysis/references/soc2/CC7-SystemOperations.md +42 -0
  197. package/skills/spec-security-analysis/references/soc2/CC8-ChangeManagement.md +32 -0
  198. package/skills/spec-security-analysis/references/soc2/CC9-RiskMitigation.md +34 -0
  199. package/skills/spec-security-analysis/references/soc2/index.md +46 -0
  200. package/skills/spec-security-analysis/references/standards-index.md +46 -0
  201. package/skills/spec-to-plan/SKILL.md +75 -0
  202. package/skills/spec-to-plan/references/step-0-plan-selection.md +121 -0
  203. package/skills/spec-to-plan/references/step-1-analysis.md +88 -0
  204. package/skills/spec-to-plan/references/step-2-test-plan.md +43 -0
  205. package/skills/spec-to-plan/references/step-3-execution-plan.md +218 -0
  206. package/skills/spec-to-plan/workflow-assets/skills/to-plan/SKILL.md +35 -0
  207. package/skills/spec-to-plan/workflow-assets/skills/to-plan/scripts/invariants.js +1 -0
  208. package/skills/spec-to-plan/workflow-assets/skills/to-plan/templates/implementation-plan/default.md +44 -0
  209. package/skills/spec-to-plan/workflow-assets/skills/to-plan/workflows/to-plan/def.yaml +85 -0
  210. package/skills/specify/SKILL.md +154 -0
  211. package/skills/specify/assets/app-spec-template.md +143 -0
  212. package/skills/specify/assets/spec-template.md +299 -0
  213. package/skills/specify/references/integration-tests.md +72 -0
  214. package/skills/specify/references/us-to-fr.md +40 -0
  215. package/skills/specify/references/writing-good-requirements.md +61 -0
@@ -0,0 +1,14 @@
1
+ {
2
+ "name": "quoin",
3
+ "interface": {
4
+ "displayName": "Quoin"
5
+ },
6
+ "plugins": [
7
+ {
8
+ "name": "quoin",
9
+ "source": { "source": "local", "path": "./" },
10
+ "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" },
11
+ "category": "Productivity"
12
+ }
13
+ ]
14
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "name": "quoin",
3
+ "owner": {
4
+ "name": "Agent IX"
5
+ },
6
+ "metadata": {
7
+ "description": "Spec authoring, review, matrix, and planning skills + workflows for Agent IX."
8
+ },
9
+ "plugins": [
10
+ {
11
+ "name": "quoin",
12
+ "source": "./",
13
+ "description": "Spec authoring, review, matrix, and planning skills for Agent IX."
14
+ }
15
+ ]
16
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "quoin",
3
+ "version": "0.1.0",
4
+ "description": "Spec authoring, review, matrix, and planning skills for Agent IX.",
5
+ "author": {
6
+ "name": "Agent IX"
7
+ }
8
+ }
@@ -0,0 +1,27 @@
1
+ {
2
+ "name": "quoin",
3
+ "version": "0.1.0",
4
+ "description": "Spec authoring, review, matrix, and planning skills for Agent IX.",
5
+ "author": {
6
+ "name": "Agent IX",
7
+ "url": "https://github.com/agent-ix"
8
+ },
9
+ "homepage": "https://github.com/agent-ix/quoin",
10
+ "repository": "https://github.com/agent-ix/quoin",
11
+ "license": "MIT",
12
+ "keywords": ["specifications", "requirements", "planning", "agent-skills"],
13
+ "skills": "./skills/",
14
+ "interface": {
15
+ "displayName": "Quoin",
16
+ "shortDescription": "Spec-driven development skills for Codex.",
17
+ "longDescription": "Quoin adds skills for authoring, reviewing, tracing, and planning software specifications.",
18
+ "developerName": "Agent IX",
19
+ "category": "Productivity",
20
+ "capabilities": ["Skills", "Planning", "Review", "Write"],
21
+ "defaultPrompt": [
22
+ "Specify a feature with Quoin.",
23
+ "Review my spec for gaps.",
24
+ "Turn requirements into a plan."
25
+ ]
26
+ }
27
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "name": "quoin",
3
+ "owner": {
4
+ "name": "Agent IX"
5
+ },
6
+ "metadata": {
7
+ "description": "Spec authoring, review, matrix, and planning skills + workflows for Agent IX."
8
+ },
9
+ "plugins": [
10
+ {
11
+ "name": "quoin",
12
+ "source": "./",
13
+ "description": "Spec authoring, review, matrix, and planning skills for Agent IX."
14
+ }
15
+ ]
16
+ }
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Agent IX
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,266 @@
1
+ <p align="center">
2
+ <img src="logo.png" alt="Quoin" width="100%" />
3
+ </p>
4
+
5
+ # Quoin
6
+
7
+ [![Discord](https://img.shields.io/badge/Discord-Join%20us-5865F2?logo=discord&logoColor=white)](https://discord.gg/6qsdhSPE)
8
+ [![ISO/IEC/IEEE 29148](https://img.shields.io/badge/ISO%2FIEC%2FIEEE-29148%20aligned-0052CC)](https://www.iso.org/standard/72089.html)
9
+ [![Open Knowledge Format](https://img.shields.io/badge/OKF-Open%20Knowledge%20Format-4285F4)](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf)
10
+
11
+ `quoin` is a bundle of **Quire modules**, **agent skills**, and **workflows** for
12
+ authoring [ISO/IEC/IEEE 29148](https://www.iso.org/standard/72089.html)-aligned software specifications and other technical
13
+ documents. It includes prepackaged modules for the spec vocabulary and ideation/authoring/review/planning
14
+ workflows agents need to write and validate specs directly as Markdown.
15
+
16
+ `quoin` is built on the [Quire](https://github.com/agent-ix/quire-rs) document standard and validation engine by Agent-IX.
17
+
18
+ > **Why:** AI agents write code fast but drift from vague intent. Quoin makes the spec the source of truth — your agent authors a validated, traceable spec first, then plans and builds against it.
19
+
20
+ ## How
21
+
22
+ In Claude Code, Codex, or the coding agent of your choice:
23
+
24
+ #### 1. Ideate & Specify
25
+
26
+ Ideate, then pass your idea to `/specify`. A `specification` containing `user stories`, `functional requirements`,
27
+ `stakeholder requirements`, `non-functional requirements`, and other artifacts will be created.
28
+
29
+ ```
30
+ > /specify an electron app for tracking spice production
31
+ ```
32
+
33
+ #### 2. Spec Review
34
+
35
+ Use `/spec-review` for agent-assisted review. Multiple analysis tasks will run in parallel and output `Reviews`
36
+ with `Findings` and suggested fixes.
37
+
38
+ ```
39
+ > /spec-review review the specs for the spice production tracker.
40
+ ```
41
+
42
+ #### 3. Convert to plans
43
+
44
+ Build the test `traceability matrix` and `plan`. These skills will break the work down into a `plan`
45
+ with multiple `tasks`.
46
+
47
+ ```
48
+ > /spec-matrix /spec-to-plan prep the spice tracking app for coding
49
+ ```
50
+
51
+ #### 4. Implement!
52
+
53
+ Call `/implement-plan` to trigger your coding agent to begin work on the plan.
54
+
55
+ ```
56
+ > /implement-plan build the spice tracking app
57
+ ```
58
+
59
+ #### 5. Gap review
60
+
61
+ `/gap-analysis` validates that the `UserStory` and `Functional Requirements` are implemented and tested using the `traceability matrix`
62
+ as the guide. `/gap-analysis` will optionally perform a _semantic_ comparison of `spec`, `code`, and `tests` to ensure the
63
+ `plan` is faithfully implemented.
64
+
65
+ ```
66
+ > /gap-analysis
67
+ ```
68
+
69
+ ## What's included
70
+
71
+ The default module set defines the spec archetypes and domain-object vocabulary.
72
+
73
+ **Artifact archetypes** — the document types you author:
74
+
75
+ | Module | Archetypes |
76
+ | ---------------------------------------------------------------------------- | -------------------------------------------------------------------- |
77
+ | [spec-artifacts-iso](https://github.com/agent-ix/spec-artifacts-iso) | `StR`, `FR`, `NFR`, `US`, `IT`, `TC`, `Spec`, `master-requirements` |
78
+ | [spec-artifacts-app](https://github.com/agent-ix/spec-artifacts-app) | `ApplicationSpec`, `MasterRequirements` |
79
+ | [spec-artifacts-process](https://github.com/agent-ix/spec-artifacts-process) | `ADR`, `Plan`, `Task`, `Review`, `Finding`, `TestMatrix`, `Standard` |
80
+
81
+ **Domain objects** — prefab templates for common objects
82
+
83
+ | Module | Objects |
84
+ | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
85
+ | [spec-objects-business](https://github.com/agent-ix/spec-objects-business) | `domain`, `entity`, `value_object`, `aggregate_root`, `nested_entity`, `repository`, `event`, `state_machine`, `process`, `enumeration` |
86
+ | [spec-objects-architecture](https://github.com/agent-ix/spec-objects-architecture) | `api_endpoint`, `data_schema`, `queue`, `action`, `ui_component`, `interface`, `external_contract`, `extension_point`, `binary_format`, `rate_limit` |
87
+ | [spec-objects-enterprise](https://github.com/agent-ix/spec-objects-enterprise) | `capability`, `business_function`, `value_stream`, `decision`, `objective`, `principle`, `kpi` |
88
+ | [spec-objects-operational](https://github.com/agent-ix/spec-objects-operational) | `configuration`, `migration`, `sli`, `slo`, `alert`, `runbook`, `incident`, `deployment` |
89
+ | [spec-objects-security](https://github.com/agent-ix/spec-objects-security) | `auth_flow`, `permission`, `scope`, `role`, `secret`, `encryption_key`, `session_config`, `data_classification`, `trust_boundary`, `audit_event`, `threat`, `control`, `risk`, `vulnerability`, `asset`, `attack_surface`, `policy`, … |
90
+
91
+ ### Agent Skills
92
+
93
+ - **`specify`** — create or edit spec files using catalog authoring packs + Quire validation
94
+ - **`spec-review`** — review specification for quality, consistency, and completeness
95
+ - **`spec-matrix`** — build/maintain the requirements Test Matrix at 100% coverage
96
+ - **`spec-to-plan`** — convert StR/FR/NFR into a TDD project plan
97
+ - **`spec-ideation`** — loose, exploratory drafting before formal authoring
98
+ - **`spec-app-review`** / **`spec-object-review`** — application-spec and domain-object audits
99
+ - Analysis lenses — focused review passes over a spec:
100
+ - **`spec-integrity-analysis`** — completeness, consistency, and atomicity quality gates
101
+ - **`spec-scope-boundary-analysis`** — system boundaries and responsibility allocation
102
+ - **`spec-dependency-analysis`** — separates enablement work from feature work
103
+ - **`spec-evidence-analysis`** — verification methods and evidence artifacts per requirement
104
+ - **`spec-failure-domain-analysis`** — unstated failure modes, identity confusion, edge cases
105
+ - **`spec-risk-complexity-analysis`** — technical risk and volatility before tasking
106
+ - **`spec-security-analysis`** — applicable security standards and compliance traceability
107
+
108
+ ## Install
109
+
110
+ Installing quoin is **two steps**: the CLI (from public npm) and a plugin that adds the
111
+ [skills](#agent-skills) and workflows to your coding agent. The same skill bundle installs
112
+ into **Claude Code, OpenAI Codex, opencode, and GitHub Copilot** — pick your agent below. No
113
+ Anthropic API key is required — your existing agent subscription is used.
114
+
115
+ **1. Install the CLIs** (`quoin` plus `ix-flow`, which runs the workflow lifecycle commands):
116
+
117
+ ```bash
118
+ npm install -g @agent-ix/quoin@latest @agent-ix/ix-flow@latest
119
+ ```
120
+
121
+ **2. Add the plugin to your coding agent:**
122
+
123
+ <details>
124
+ <summary><b>Claude Code</b></summary>
125
+
126
+ Run these inside Claude Code:
127
+
128
+ ```text
129
+ /plugin marketplace add agent-ix/quoin
130
+ /plugin install quoin@quoin
131
+ ```
132
+
133
+ </details>
134
+
135
+ <details>
136
+ <summary><b>OpenAI Codex</b></summary>
137
+
138
+ ```bash
139
+ codex plugin marketplace add agent-ix/quoin
140
+ codex plugin add quoin
141
+ ```
142
+
143
+ Or browse and install quoin from the `/plugins` menu inside the Codex TUI.
144
+
145
+ </details>
146
+
147
+ <details>
148
+ <summary><b>opencode</b></summary>
149
+
150
+ Install the skills with the GitHub CLI (requires `gh` ≥ 2.90.0). `--all` installs
151
+ the whole bundle; `--scope user` makes it available in every repo:
152
+
153
+ ```bash
154
+ gh skill install agent-ix/quoin --all --scope user --agent opencode
155
+ ```
156
+
157
+ </details>
158
+
159
+ <details>
160
+ <summary><b>GitHub Copilot</b></summary>
161
+
162
+ With the Copilot CLI:
163
+
164
+ ```bash
165
+ copilot plugin marketplace add agent-ix/quoin
166
+ copilot plugin install quoin@quoin
167
+ ```
168
+
169
+ Or install the skills with the GitHub CLI (requires `gh` ≥ 2.90.0):
170
+
171
+ ```bash
172
+ gh skill install agent-ix/quoin --all --scope user --agent github-copilot
173
+ ```
174
+
175
+ </details>
176
+
177
+ Either way, that registers quoin's spec-authoring skills and workflows so you can drive them
178
+ by asking the agent.
179
+
180
+ ## Usage
181
+
182
+ ### skills & workflows
183
+
184
+ The primary way users author specs is by asking an agent, which invokes the bundled
185
+ [skills](#agent-skills) and [workflows](#agent-workflows).
186
+
187
+ ### CLI commands
188
+
189
+ Inspect the spec vocabulary and manage installed modules:
190
+
191
+ ```bash
192
+ quoin catalog list
193
+ quoin catalog show FR
194
+ quoin catalog validate
195
+ quoin plugin install path:../spec-objects-business
196
+ quoin plugin list
197
+ ```
198
+
199
+ ## Development
200
+
201
+ ```bash
202
+ pnpm install
203
+ pnpm run build
204
+ pnpm test
205
+ pnpm run lint
206
+ ```
207
+
208
+ ### Specification
209
+
210
+ The technical specification for this library was itself authored with the `spec-artifacts-iso` module — see
211
+ [spec/spec.md](spec/spec.md).
212
+
213
+ ### Evals
214
+
215
+ Eval scenarios live in [spec/evals.md](spec/evals.md) and run through the shared
216
+ [`@agent-ix/cli-agent-evals`](../cli-agent-evals) toolkit. The suite definition is
217
+ [`cli-agent-evals.config.mjs`](cli-agent-evals.config.mjs); quoin-specific fixtures,
218
+ module seeding, prompts, and assertions remain under [`evals/`](evals/).
219
+
220
+ Live runs profile a **real** agent running the skills/workflows and record token,
221
+ tool, and latency metrics from the available transcript. Unit tests cover the
222
+ mechanical CLI behavior.
223
+
224
+ ```bash
225
+ make evals
226
+ make evals-all
227
+ node ../cli-agent-evals/bin/cli-evals.js run \
228
+ --suite ./cli-agent-evals.config.mjs \
229
+ --canary \
230
+ --agent claude \
231
+ --model sonnet
232
+ ```
233
+
234
+ Agent plugin setup for authoring/running evals from an agent:
235
+
236
+ ```bash
237
+ claude plugin marketplace add agent-ix/cli-agent-evals
238
+ claude plugin install cli-agent-evals
239
+
240
+ codex plugin marketplace add agent-ix/cli-agent-evals
241
+ codex plugin add cli-agent-evals
242
+
243
+ gh skill install agent-ix/cli-agent-evals --all --scope user --agent opencode
244
+ gh skill install agent-ix/cli-agent-evals --all --scope user --agent github-copilot
245
+ ```
246
+
247
+ Minimal integration pattern:
248
+
249
+ ```js
250
+ import { defineSuite } from "../cli-agent-evals/dist/index.js";
251
+ import { SCENARIOS } from "./evals/scenarios/index.mjs";
252
+
253
+ export default defineSuite({
254
+ name: "quoin",
255
+ rootDir: import.meta.dirname,
256
+ scenarios: SCENARIOS,
257
+ });
258
+ ```
259
+
260
+ ## About
261
+
262
+ quoin is part of the Agent-IX ecosystem built on these core libraries:
263
+
264
+ - [quire-cli](https://github.com/agent-ix/quire-cli), the static-binary CLI wrapping the Quire engine
265
+ - [ix-cli-core](https://github.com/agent-ix/ix-cli-core), the generic CLI framework
266
+ for Agent IX.
package/bin/quoin.js ADDED
@@ -0,0 +1,14 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { execute } from "@agent-ix/ix-cli-core";
4
+
5
+ import { isVersionRequest, packageVersion } from "../dist/cli.js";
6
+
7
+ const argv = process.argv.slice(2);
8
+
9
+ // Preserve quoin's bare build-time version output ahead of the oclif runner.
10
+ if (isVersionRequest(argv)) {
11
+ console.log(packageVersion());
12
+ } else {
13
+ await execute({ dir: import.meta.url });
14
+ }
@@ -0,0 +1,82 @@
1
+ # Default Filament module set shipped with quoin.
2
+ #
3
+ # Lazily installed into ~/.ix/filament/modules on first catalog access (see
4
+ # src/modules.ts). Each entry sparse-checks out one module's data subdir from its
5
+ # canonical repo at a pinned tag — the same git tag the Python wheel is built
6
+ # from. This file is the canonical-ready source of truth for the module set +
7
+ # pins (a future generator can derive the backend pyproject pins / activation
8
+ # list from it).
9
+ schemaVersion: 1
10
+ name: quoin-default-modules
11
+ entries:
12
+ - name: spec-artifacts-iso
13
+ version: "0.5.0"
14
+ defaultEnabled: true
15
+ source:
16
+ type: git-subdir
17
+ url: agent-ix/spec-artifacts-iso
18
+ path: spec_artifacts_iso
19
+ ref: v0.5.0
20
+
21
+ - name: spec-artifacts-app
22
+ version: "0.3.0"
23
+ defaultEnabled: true
24
+ source:
25
+ type: git-subdir
26
+ url: agent-ix/spec-artifacts-app
27
+ path: spec_artifacts_app
28
+ ref: v0.3.0
29
+
30
+ - name: spec-artifacts-process
31
+ version: "0.5.0"
32
+ defaultEnabled: true
33
+ source:
34
+ type: git-subdir
35
+ url: agent-ix/spec-artifacts-process
36
+ path: spec_artifacts_process
37
+ ref: v0.5.0
38
+
39
+ - name: spec-objects-business
40
+ version: "0.4.0"
41
+ defaultEnabled: true
42
+ source:
43
+ type: git-subdir
44
+ url: agent-ix/spec-objects-business
45
+ path: spec_objects_business
46
+ ref: v0.4.0
47
+
48
+ - name: spec-objects-architecture
49
+ version: "0.4.0"
50
+ defaultEnabled: true
51
+ source:
52
+ type: git-subdir
53
+ url: agent-ix/spec-objects-architecture
54
+ path: spec_objects_architecture
55
+ ref: v0.4.0
56
+
57
+ - name: spec-objects-enterprise
58
+ version: "0.3.0"
59
+ defaultEnabled: true
60
+ source:
61
+ type: git-subdir
62
+ url: agent-ix/spec-objects-enterprise
63
+ path: spec_objects_enterprise
64
+ ref: v0.3.0
65
+
66
+ - name: spec-objects-operational
67
+ version: "0.4.0"
68
+ defaultEnabled: true
69
+ source:
70
+ type: git-subdir
71
+ url: agent-ix/spec-objects-operational
72
+ path: spec_objects_operational
73
+ ref: v0.4.0
74
+
75
+ - name: spec-objects-security
76
+ version: "0.3.0"
77
+ defaultEnabled: true
78
+ source:
79
+ type: git-subdir
80
+ url: agent-ix/spec-objects-security
81
+ path: spec_objects_security
82
+ ref: v0.3.0
@@ -0,0 +1,137 @@
1
+ import { t as e } from "./version-_1nY4KyJ.js";
2
+ import { BaseCommand as t, maybeOfferUpdate as n } from "@agent-ix/ix-cli-core";
3
+ import { existsSync as r, readFileSync as i, readdirSync as a, statSync as o } from "node:fs";
4
+ import { basename as s, join as c, resolve as l } from "node:path";
5
+ import { homedir as u } from "node:os";
6
+ import { parse as d } from "yaml";
7
+ //#region src/catalog.ts
8
+ function f() {
9
+ return process.env.IX_HOME && process.env.IX_HOME.length > 0 ? process.env.IX_HOME : c(u(), ".ix");
10
+ }
11
+ function p(e = f()) {
12
+ return c(e, "filament", "modules");
13
+ }
14
+ function m(e = f()) {
15
+ let t = [], n = process.env.QUOIN_MODULE_PATHS;
16
+ n && t.push(...n.split(":").filter(Boolean));
17
+ let i = p(e);
18
+ if (r(i)) for (let e of a(i)) t.push(c(i, e));
19
+ return t;
20
+ }
21
+ function h(e = m()) {
22
+ let t = [], n = [], r = /* @__PURE__ */ new Set(), a = /* @__PURE__ */ new Set();
23
+ for (let o of e) {
24
+ let e = v(o);
25
+ if (!e || r.has(e)) continue;
26
+ r.add(e);
27
+ let l = d(i(c(e, "manifest.yaml"), "utf8")), u = x(l.name) ?? s(e);
28
+ if (a.has(u)) continue;
29
+ a.add(u);
30
+ let f = b(l.artifact_types), p = b(l.object_types);
31
+ t.push({
32
+ name: u,
33
+ version: x(l.version),
34
+ root: e,
35
+ artifactTypes: f.map((e) => String(e.name)),
36
+ objectTypes: p.map((e) => String(e.name))
37
+ });
38
+ for (let t of f) {
39
+ let r = String(t.name), i = x(t.frontmatter_schema_ref);
40
+ n.push({
41
+ name: r,
42
+ kind: "artifact",
43
+ moduleName: u,
44
+ moduleRoot: e,
45
+ schemaRef: i,
46
+ schemaPath: i ? c(e, i) : void 0,
47
+ skeletonPath: y(e, r)
48
+ });
49
+ }
50
+ for (let t of p) {
51
+ let r = String(t.name);
52
+ n.push({
53
+ name: r,
54
+ kind: "object",
55
+ moduleName: u,
56
+ moduleRoot: e,
57
+ skeletonPath: y(e, r)
58
+ });
59
+ }
60
+ }
61
+ return {
62
+ modules: t,
63
+ entries: n,
64
+ duplicates: S(n)
65
+ };
66
+ }
67
+ function g(e, t) {
68
+ let n = _(t);
69
+ return e.entries.find((e) => _(e.name) === n);
70
+ }
71
+ function _(e) {
72
+ return e.toLowerCase();
73
+ }
74
+ function v(e) {
75
+ let t = l(e);
76
+ if (r(t)) {
77
+ if (r(c(t, "manifest.yaml"))) return t;
78
+ if (o(t).isDirectory()) for (let e of a(t)) {
79
+ let n = c(t, e);
80
+ if (r(c(n, "manifest.yaml"))) return n;
81
+ }
82
+ }
83
+ }
84
+ function y(e, t) {
85
+ let n = c(e, "skeletons"), r;
86
+ try {
87
+ r = a(n);
88
+ } catch {
89
+ return;
90
+ }
91
+ let i = [`${t}.md`, `${t.toLowerCase()}.md`].find((e) => r.includes(e));
92
+ return i ? c(n, i) : void 0;
93
+ }
94
+ function b(e) {
95
+ return Array.isArray(e) ? e.filter((e) => !!e && typeof e == "object" && "name" in e) : [];
96
+ }
97
+ function x(e) {
98
+ return typeof e == "string" ? e : void 0;
99
+ }
100
+ function S(e) {
101
+ let t = /* @__PURE__ */ new Map();
102
+ for (let n of e) {
103
+ let e = `${n.kind}:${n.name}`, r = t.get(e) ?? /* @__PURE__ */ new Set();
104
+ r.add(n.moduleName), t.set(e, r);
105
+ }
106
+ return [...t.entries()].filter(([, e]) => e.size > 1).map(([e, t]) => {
107
+ let [n, r] = e.split(":");
108
+ return {
109
+ kind: n,
110
+ name: r,
111
+ modules: [...t].sort()
112
+ };
113
+ });
114
+ }
115
+ //#endregion
116
+ //#region src/base.ts
117
+ var C = class extends t {
118
+ skipUpdateNudge = !1;
119
+ home = "";
120
+ async init() {
121
+ await super.init();
122
+ let t = w(this.argv) ?? process.env.IX_CONFIG_ROOT;
123
+ this.home = typeof t == "string" && t.length > 0 ? t : f(), process.env.IX_HOME = this.home, !this.skipUpdateNudge && !this.argv.includes("--json") && await n({
124
+ packageName: "@agent-ix/quoin",
125
+ currentVersion: e()
126
+ });
127
+ }
128
+ };
129
+ function w(e) {
130
+ for (let t = 0; t < e.length; t++) {
131
+ let n = e[t];
132
+ if (n === "--config-root") return e[t + 1];
133
+ if (n.startsWith("--config-root=")) return n.slice(14);
134
+ }
135
+ }
136
+ //#endregion
137
+ export { f as a, g as i, m as n, h as o, p as r, C as t };
package/dist/base.d.ts ADDED
@@ -0,0 +1,23 @@
1
+ import { BaseCommand } from '@agent-ix/ix-cli-core';
2
+ /**
3
+ * Shared base for every quoin command.
4
+ *
5
+ * Extends ix-cli-core's {@link BaseCommand} (which owns the `--config-root` /
6
+ * `--no-project-config` global flags and the capability lifecycle) and adds the
7
+ * two cross-cutting concerns the legacy hand-rolled dispatcher used to apply to
8
+ * every invocation:
9
+ *
10
+ * 1. Resolve the quoin home (`--config-root` flag, else `IX_HOME`) and export
11
+ * it as `process.env.IX_HOME` so the catalog / module modules — which read
12
+ * `ixHome()` — observe the per-invocation override exactly as before.
13
+ * 2. Nudge toward a newer published quoin (throttled, interactive-only, silent
14
+ * in CI / under `--json` / for `update` itself). Never blocks or throws.
15
+ */
16
+ export declare abstract class QuoinCommand extends BaseCommand {
17
+ /** Commands that must not trigger the update nudge (e.g. `update`). */
18
+ protected skipUpdateNudge: boolean;
19
+ /** Resolved quoin home for this invocation. */
20
+ protected home: string;
21
+ init(): Promise<void>;
22
+ }
23
+ //# sourceMappingURL=base.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,uBAAuB,CAAC;AAKtE;;;;;;;;;;;;;GAaG;AACH,8BAAsB,YAAa,SAAQ,WAAW;IACpD,uEAAuE;IACvE,SAAS,CAAC,eAAe,UAAS;IAElC,+CAA+C;IAC/C,SAAS,CAAC,IAAI,SAAM;IAEE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAkB5C"}
@@ -0,0 +1,32 @@
1
+ export interface SpecCatalogEntry {
2
+ name: string;
3
+ kind: "artifact" | "object";
4
+ moduleName: string;
5
+ moduleRoot: string;
6
+ schemaRef?: string;
7
+ schemaPath?: string;
8
+ skeletonPath?: string;
9
+ }
10
+ export interface SpecModule {
11
+ name: string;
12
+ version?: string;
13
+ root: string;
14
+ artifactTypes: string[];
15
+ objectTypes: string[];
16
+ }
17
+ export interface SpecCatalog {
18
+ modules: SpecModule[];
19
+ entries: SpecCatalogEntry[];
20
+ duplicates: Array<{
21
+ kind: "artifact" | "object";
22
+ name: string;
23
+ modules: string[];
24
+ }>;
25
+ }
26
+ export declare function ixHome(): string;
27
+ /** The single directory that holds installed Filament modules; also read by quire-rs. */
28
+ export declare function filamentModulesDir(home?: string): string;
29
+ export declare function defaultModuleRoots(home?: string): string[];
30
+ export declare function loadCatalog(moduleRoots?: string[]): SpecCatalog;
31
+ export declare function findCatalogEntry(catalog: SpecCatalog, name: string): SpecCatalogEntry | undefined;
32
+ //# sourceMappingURL=catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,wBAAgB,MAAM,IAAI,MAAM,CAI/B;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,IAAI,SAAW,GAAG,MAAM,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,SAAW,GAAG,MAAM,EAAE,CAW5D;AAED,wBAAgB,WAAW,CAAC,WAAW,WAAuB,GAAG,WAAW,CAyD3E;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,SAAS,CAK9B"}