project-iris 0.0.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.
Files changed (729) hide show
  1. package/README.md +424 -0
  2. package/dist/bridge/agent-runner.js +190 -0
  3. package/dist/bridge/connector-factory.js +31 -0
  4. package/dist/bridge/connectors/antigravity-connector.js +18 -0
  5. package/dist/bridge/connectors/cursor-connector.js +31 -0
  6. package/dist/bridge/connectors/in-process-connector.js +29 -0
  7. package/dist/bridge/connectors/vscode-connector.js +31 -0
  8. package/dist/bridge/connectors/windsurf-connector.js +23 -0
  9. package/dist/bridge/filesystem-connector.js +110 -0
  10. package/dist/bridge/helper.js +203 -0
  11. package/dist/bridge/types.js +10 -0
  12. package/dist/cli.js +38 -0
  13. package/dist/commands/ask.js +259 -0
  14. package/dist/commands/bridge.js +88 -0
  15. package/dist/commands/develop.js +141 -0
  16. package/dist/commands/doctor.js +102 -0
  17. package/dist/commands/flow.js +301 -0
  18. package/dist/commands/framework.js +273 -0
  19. package/dist/commands/generate.js +59 -0
  20. package/dist/commands/install.js +73 -0
  21. package/dist/commands/pack.js +33 -0
  22. package/dist/commands/phase.js +38 -0
  23. package/dist/commands/run.js +199 -0
  24. package/dist/commands/status.js +114 -0
  25. package/dist/commands/uninstall.js +14 -0
  26. package/dist/commands/use.js +20 -0
  27. package/dist/commands/validate.js +102 -0
  28. package/dist/framework/framework-loader.js +97 -0
  29. package/dist/framework/framework-paths.js +48 -0
  30. package/dist/framework/framework-types.js +15 -0
  31. package/dist/iris/artifact-checker.js +78 -0
  32. package/dist/iris/artifacts/config.js +68 -0
  33. package/dist/iris/artifacts/generator.js +88 -0
  34. package/dist/iris/artifacts/types.js +1 -0
  35. package/dist/iris/bundle.js +44 -0
  36. package/dist/iris/doctrine/collector.js +124 -0
  37. package/dist/iris/fixer.js +149 -0
  38. package/dist/iris/flows/manifest.js +124 -0
  39. package/dist/iris/framework-context.js +49 -0
  40. package/dist/iris/framework-manager.js +215 -0
  41. package/dist/iris/fs/atomic.js +22 -0
  42. package/dist/iris/guard.js +38 -0
  43. package/dist/iris/importers/bmad.js +70 -0
  44. package/dist/iris/importers/index.js +9 -0
  45. package/dist/iris/importers/speckit.js +15 -0
  46. package/dist/iris/importers/specsmd.js +78 -0
  47. package/dist/iris/importers/types.js +8 -0
  48. package/dist/iris/importers/writer.js +139 -0
  49. package/dist/iris/include.js +49 -0
  50. package/dist/iris/installer.js +334 -0
  51. package/dist/iris/interactive/env.js +21 -0
  52. package/dist/iris/interactive/intent-interview.js +345 -0
  53. package/dist/iris/interactive/intent-schema.js +28 -0
  54. package/dist/iris/interactive/interview-io.js +22 -0
  55. package/dist/iris/interview/config.js +71 -0
  56. package/dist/iris/interview/types.js +16 -0
  57. package/dist/iris/interview/utils.js +38 -0
  58. package/dist/iris/manifest.js +54 -0
  59. package/dist/iris/packer.js +325 -0
  60. package/dist/iris/parsers/unit-parser.js +43 -0
  61. package/dist/iris/paths.js +18 -0
  62. package/dist/iris/policy.js +133 -0
  63. package/dist/iris/proc.js +56 -0
  64. package/dist/iris/report.js +53 -0
  65. package/dist/iris/resolver.js +66 -0
  66. package/dist/iris/router.js +114 -0
  67. package/dist/iris/routes.js +189 -0
  68. package/dist/iris/run-state.js +146 -0
  69. package/dist/iris/state.js +113 -0
  70. package/dist/iris/templates.js +70 -0
  71. package/dist/iris/tmp.js +24 -0
  72. package/dist/iris/uninstaller.js +181 -0
  73. package/dist/iris/utils/interpolate.js +42 -0
  74. package/dist/iris/validator.js +391 -0
  75. package/dist/iris/workflow/config.js +51 -0
  76. package/dist/iris/workflow/engine.js +129 -0
  77. package/dist/iris/workflow/steps.js +448 -0
  78. package/dist/iris/workflow/types.js +1 -0
  79. package/dist/lib.js +96 -0
  80. package/dist/utils/exit-codes.js +7 -0
  81. package/dist/workflows/bolt-execution.js +238 -0
  82. package/dist/workflows/bolt-plan.js +192 -0
  83. package/dist/workflows/intent-inception.js +210 -0
  84. package/dist/workflows/reporting.js +74 -0
  85. package/package.json +45 -0
  86. package/src/iris_bundle/.iris/aidlc/README.md +16 -0
  87. package/src/iris_bundle/.iris/aidlc/agents/iris-construction-agent.md +35 -0
  88. package/src/iris_bundle/.iris/aidlc/agents/iris-inception-agent.md +30 -0
  89. package/src/iris_bundle/.iris/aidlc/agents/iris-master-agent.md +35 -0
  90. package/src/iris_bundle/.iris/aidlc/agents/iris-operations-agent.md +29 -0
  91. package/src/iris_bundle/.iris/aidlc/commands/iris-construction-agent.md +18 -0
  92. package/src/iris_bundle/.iris/aidlc/commands/iris-inception-agent.md +18 -0
  93. package/src/iris_bundle/.iris/aidlc/commands/iris-master-agent.md +18 -0
  94. package/src/iris_bundle/.iris/aidlc/commands/iris-operations-agent.md +18 -0
  95. package/src/iris_bundle/.iris/aidlc/context/context-map.md +25 -0
  96. package/src/iris_bundle/.iris/aidlc/context/exclusion-rules.md +13 -0
  97. package/src/iris_bundle/.iris/aidlc/context/load-order.md +25 -0
  98. package/src/iris_bundle/.iris/aidlc/memory/intent-rules.md +9 -0
  99. package/src/iris_bundle/.iris/aidlc/memory/log-rules.md +5 -0
  100. package/src/iris_bundle/.iris/aidlc/memory/memory-bank.yaml +39 -0
  101. package/src/iris_bundle/.iris/aidlc/memory/unit-rules.md +9 -0
  102. package/src/iris_bundle/.iris/aidlc/quick-start.md +24 -0
  103. package/src/iris_bundle/.iris/aidlc/skills/execution/implementation.md +14 -0
  104. package/src/iris_bundle/.iris/aidlc/skills/execution/refactoring.md +13 -0
  105. package/src/iris_bundle/.iris/aidlc/skills/execution/scaffold-generation.md +15 -0
  106. package/src/iris_bundle/.iris/aidlc/skills/governance/escalation.md +13 -0
  107. package/src/iris_bundle/.iris/aidlc/skills/governance/quality-gates.md +14 -0
  108. package/src/iris_bundle/.iris/aidlc/skills/governance/stop-conditions.md +11 -0
  109. package/src/iris_bundle/.iris/aidlc/skills/reasoning/decomposition.md +23 -0
  110. package/src/iris_bundle/.iris/aidlc/skills/reasoning/risk-analysis.md +14 -0
  111. package/src/iris_bundle/.iris/aidlc/skills/reasoning/verification.md +21 -0
  112. package/src/iris_bundle/.iris/aidlc/standards/artifacts-registry.md +38 -0
  113. package/src/iris_bundle/.iris/aidlc/standards/decision-logging.md +16 -0
  114. package/src/iris_bundle/.iris/aidlc/standards/doctrine-structure.md +31 -0
  115. package/src/iris_bundle/.iris/aidlc/standards/documentation-rules.md +15 -0
  116. package/src/iris_bundle/.iris/aidlc/standards/file-structure.md +21 -0
  117. package/src/iris_bundle/.iris/aidlc/standards/naming-conventions.md +18 -0
  118. package/src/iris_bundle/.iris/aidlc/standards/phases-and-gates.md +25 -0
  119. package/src/iris_bundle/.iris/aidlc/standards/routes-and-routing.md +35 -0
  120. package/src/iris_bundle/.iris/aidlc/standards/tool-wrappers.md +32 -0
  121. package/src/iris_bundle/.iris/aidlc/templates/bolt.md +23 -0
  122. package/src/iris_bundle/.iris/aidlc/templates/doctrine-doc-template.md +33 -0
  123. package/src/iris_bundle/.iris/aidlc/templates/intent.md +23 -0
  124. package/src/iris_bundle/.iris/aidlc/templates/log.md +24 -0
  125. package/src/iris_bundle/.iris/aidlc/templates/review.md +21 -0
  126. package/src/iris_bundle/.iris/aidlc/templates/unit.md +31 -0
  127. package/src/iris_bundle/.iris/aidlc/validation/failure-modes.md +16 -0
  128. package/src/iris_bundle/.iris/aidlc/validation/phase-preconditions.md +21 -0
  129. package/src/iris_bundle/.iris/aidlc/validation/quality-checklist.md +20 -0
  130. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/requirements.md +18 -0
  131. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/system-context.md +17 -0
  132. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/unit-briefs/construction.md +16 -0
  133. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/unit-briefs/operations.md +14 -0
  134. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/units.md +11 -0
  135. package/src/iris_bundle/.iris/flows/specs-md/flow.yaml +8 -0
  136. package/src/iris_bundle/.iris/flows/specs-md/policy.overlay.yaml +26 -0
  137. package/src/iris_bundle/.iris/flows/specs-md/routes.overlay.yaml +16 -0
  138. package/src/iris_bundle/.iris/policy.yaml +27 -0
  139. package/src/iris_bundle/.iris/routes.yaml +98 -0
  140. package/src/iris_bundle/.iris/state.yaml +7 -0
  141. package/src/iris_bundle/.iris/tools/claude/.claude/claude.md +9 -0
  142. package/src/iris_bundle/.iris/tools/claude/.claude/commands/compare-specs.md +203 -0
  143. package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-construction-agent.md +25 -0
  144. package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-inception-agent.md +25 -0
  145. package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-master-agent.md +25 -0
  146. package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-operations-agent.md +25 -0
  147. package/src/iris_bundle/.iris/tools/codex/AGENTS.md +15 -0
  148. package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-construction-agent.md +25 -0
  149. package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-inception-agent.md +25 -0
  150. package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-master-agent.md +25 -0
  151. package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-operations-agent.md +25 -0
  152. package/src/iris_bundle/.iris/tools/gemini/.gemini/commands/iris-construction-agent.toml +29 -0
  153. package/src/iris_bundle/.iris/tools/gemini/.gemini/commands/iris-inception-agent.toml +29 -0
  154. package/src/iris_bundle/.iris/tools/gemini/.gemini/commands/iris-master-agent.toml +29 -0
  155. package/src/iris_bundle/.iris/tools/gemini/.gemini/commands/iris-operations-agent.toml +29 -0
  156. package/src/iris_bundle/frameworks/iris-core/.claude/claude.md +238 -0
  157. package/src/iris_bundle/frameworks/iris-core/.claude/commands/compare-iris.md +203 -0
  158. package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-construction-agent.md +63 -0
  159. package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-inception-agent.md +55 -0
  160. package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-master-agent.md +47 -0
  161. package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-operations-agent.md +77 -0
  162. package/src/iris_bundle/frameworks/iris-core/.github/workflows/claude-code-review.yml +57 -0
  163. package/src/iris_bundle/frameworks/iris-core/.github/workflows/claude.yml +50 -0
  164. package/src/iris_bundle/frameworks/iris-core/.github/workflows/npm-package-ci.yml +46 -0
  165. package/src/iris_bundle/frameworks/iris-core/.github/workflows/npm-package-dev.yml +59 -0
  166. package/src/iris_bundle/frameworks/iris-core/.github/workflows/npm-package-release.yml +107 -0
  167. package/src/iris_bundle/frameworks/iris-core/.github/workflows/vscode-publish.yml +113 -0
  168. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/README.md +372 -0
  169. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/agents/construction-agent.md +80 -0
  170. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/agents/inception-agent.md +97 -0
  171. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/agents/master-agent.md +61 -0
  172. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/agents/operations-agent.md +89 -0
  173. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/commands/construction-agent.md +63 -0
  174. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/commands/inception-agent.md +55 -0
  175. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/commands/master-agent.md +47 -0
  176. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/commands/operations-agent.md +77 -0
  177. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/context-config.yaml +67 -0
  178. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/memory-bank.yaml +104 -0
  179. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/quick-start.md +322 -0
  180. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/bolt-list.md +163 -0
  181. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/bolt-replan.md +345 -0
  182. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/bolt-start.md +442 -0
  183. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/bolt-status.md +185 -0
  184. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/navigator.md +196 -0
  185. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/bolt-plan.md +372 -0
  186. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/context.md +171 -0
  187. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/intent-create.md +211 -0
  188. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/intent-list.md +124 -0
  189. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/navigator.md +207 -0
  190. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/requirements.md +227 -0
  191. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/review.md +248 -0
  192. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/story-create.md +304 -0
  193. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/units.md +278 -0
  194. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/analyze-context.md +239 -0
  195. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/answer-question.md +141 -0
  196. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/explain-flow.md +158 -0
  197. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/project-init.md +281 -0
  198. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/route-request.md +126 -0
  199. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/build.md +237 -0
  200. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/deploy.md +259 -0
  201. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/monitor.md +265 -0
  202. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/navigator.md +209 -0
  203. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/verify.md +224 -0
  204. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-template.md +226 -0
  205. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt/adr-template.md +49 -0
  206. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-01-domain-model-template.md +55 -0
  207. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-02-technical-design-template.md +67 -0
  208. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-03-test-report-template.md +62 -0
  209. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt.md +528 -0
  210. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/simple-construction-bolt.md +347 -0
  211. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/spike-bolt.md +240 -0
  212. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/construction-log-template.md +129 -0
  213. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/standards/coding-standards.md +29 -0
  214. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/standards/system-architecture.md +22 -0
  215. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/standards/tech-stack.md +19 -0
  216. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/inception-log-template.md +134 -0
  217. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/project/README.md +55 -0
  218. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/requirements-template.md +144 -0
  219. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/stories-template.md +38 -0
  220. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/story-template.md +147 -0
  221. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/system-context-template.md +29 -0
  222. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/unit-brief-template.md +177 -0
  223. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/units-template.md +52 -0
  224. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/standards/catalog.yaml +345 -0
  225. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/standards/coding-standards.guide.md +553 -0
  226. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/standards/data-stack.guide.md +162 -0
  227. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/standards/tech-stack.guide.md +280 -0
  228. package/src/iris_bundle/frameworks/iris-core/.markdownlint.yaml +142 -0
  229. package/src/iris_bundle/frameworks/iris-core/LICENSE +21 -0
  230. package/src/iris_bundle/frameworks/iris-core/PRIVACY.md +38 -0
  231. package/src/iris_bundle/frameworks/iris-core/README.md +397 -0
  232. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/framework.yaml +4 -0
  233. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/interview.yaml +9 -0
  234. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/pack.yaml +2 -0
  235. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/policy.yaml +27 -0
  236. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/routes.yaml +98 -0
  237. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/bolt.md +23 -0
  238. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/doctrine-doc-template.md +33 -0
  239. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/intent.md +23 -0
  240. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/log.md +24 -0
  241. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/review.md +21 -0
  242. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/unit.md +31 -0
  243. package/src/iris_bundle/frameworks/iris-core/artifacts.yaml +78 -0
  244. package/src/iris_bundle/frameworks/iris-core/dev_release_guide.md +324 -0
  245. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/.claude/skills/frontend-design/SKILL.md +106 -0
  246. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/CLAUDE.md +171 -0
  247. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/README.md +20 -0
  248. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/construction-agent.mdx +358 -0
  249. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/inception-agent.mdx +306 -0
  250. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/master-agent.mdx +230 -0
  251. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/operations-agent.mdx +344 -0
  252. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/overview.mdx +187 -0
  253. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/architecture/flows.mdx +136 -0
  254. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/community.mdx +91 -0
  255. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/overview.mdx +167 -0
  256. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/vs-bmad.mdx +167 -0
  257. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/vs-kiro.mdx +208 -0
  258. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/vs-openspec.mdx +140 -0
  259. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/vs-speckit.mdx +146 -0
  260. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/bolts.mdx +268 -0
  261. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/intents.mdx +164 -0
  262. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/memory-bank.mdx +209 -0
  263. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/standards.mdx +277 -0
  264. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/units.mdx +184 -0
  265. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/docs.json +148 -0
  266. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/faq.mdx +364 -0
  267. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/feedback.mdx +55 -0
  268. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/getting-started/installation.mdx +91 -0
  269. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/getting-started/quick-start.mdx +149 -0
  270. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/getting-started/vscode-extension.mdx +180 -0
  271. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/guides/bolt-types.mdx +182 -0
  272. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/extension-gallery/bolts.jpeg +0 -0
  273. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/extension-gallery/overview.jpeg +0 -0
  274. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/extension-gallery/specs.jpeg +0 -0
  275. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/extension-preview.png +0 -0
  276. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/favicon.png +0 -0
  277. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/hero-dark.svg +129 -0
  278. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/hero-light.svg +129 -0
  279. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/logo.png +0 -0
  280. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/old_favicon.svg +40 -0
  281. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/quickstart.cast +3788 -0
  282. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/quickstart.gif +0 -0
  283. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/index.mdx +179 -0
  284. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/methodology/ai-dlc-vs-agile.mdx +138 -0
  285. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/methodology/sdlc-reimagined.mdx +270 -0
  286. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/methodology/three-phases.mdx +225 -0
  287. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/methodology/what-is-ai-dlc.mdx +96 -0
  288. package/src/iris_bundle/frameworks/iris-core/framework.yaml +4 -0
  289. package/src/iris_bundle/frameworks/iris-core/images/763995.png +0 -0
  290. package/src/iris_bundle/frameworks/iris-core/images/763995.svg +354 -0
  291. package/src/iris_bundle/frameworks/iris-core/images/favicon-64.png +0 -0
  292. package/src/iris_bundle/frameworks/iris-core/images/favicon.png +0 -0
  293. package/src/iris_bundle/frameworks/iris-core/images/logo.png +0 -0
  294. package/src/iris_bundle/frameworks/iris-core/images/old_favicon.svg +40 -0
  295. package/src/iris_bundle/frameworks/iris-core/images/specs_md_pixel_logo.png +0 -0
  296. package/src/iris_bundle/frameworks/iris-core/images/specs_md_pixel_logo_big.png +0 -0
  297. package/src/iris_bundle/frameworks/iris-core/interview.yaml +48 -0
  298. package/src/iris_bundle/frameworks/iris-core/memory-bank/PRFAQ.md +193 -0
  299. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/016-analytics-tracker/bolt.md +122 -0
  300. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/016-analytics-tracker/implementation-plan.md +172 -0
  301. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/016-analytics-tracker/implementation-walkthrough.md +56 -0
  302. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/016-analytics-tracker/test-walkthrough.md +96 -0
  303. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/017-privacy-documentation/bolt.md +72 -0
  304. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-1/bolt.md +94 -0
  305. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-1/implementation-plan.md +297 -0
  306. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-1/implementation-walkthrough.md +56 -0
  307. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-1/test-walkthrough.md +99 -0
  308. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-2/bolt.md +88 -0
  309. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-2/implementation-plan.md +196 -0
  310. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-2/implementation-walkthrough.md +154 -0
  311. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-2/test-walkthrough.md +119 -0
  312. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-extension-core-1/bolt.md +99 -0
  313. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-extension-core-1/implementation-plan.md +70 -0
  314. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-extension-core-1/implementation-walkthrough.md +45 -0
  315. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-extension-core-1/test-walkthrough.md +60 -0
  316. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-file-watcher-1/bolt.md +86 -0
  317. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-file-watcher-1/implementation-plan.md +154 -0
  318. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-file-watcher-1/implementation-walkthrough.md +43 -0
  319. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-file-watcher-1/test-walkthrough.md +74 -0
  320. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-1/bolt.md +89 -0
  321. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-1/implementation-plan.md +76 -0
  322. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-1/implementation-walkthrough.md +43 -0
  323. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-1/test-walkthrough.md +70 -0
  324. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-2/bolt.md +90 -0
  325. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-2/implementation-plan.md +93 -0
  326. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-2/implementation-walkthrough.md +44 -0
  327. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-2/test-walkthrough.md +54 -0
  328. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-3/bolt.md +90 -0
  329. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-3/implementation-plan.md +168 -0
  330. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-3/implementation-walkthrough.md +137 -0
  331. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-3/test-walkthrough.md +134 -0
  332. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-4/bolt.md +93 -0
  333. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-4/implementation-plan.md +176 -0
  334. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-4/implementation-walkthrough.md +159 -0
  335. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-4/test-walkthrough.md +105 -0
  336. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-5/bolt.md +104 -0
  337. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-5/implementation-plan.md +146 -0
  338. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-1/bolt.md +83 -0
  339. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-1/implementation-plan.md +161 -0
  340. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-1/implementation-walkthrough.md +58 -0
  341. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-1/test-walkthrough.md +104 -0
  342. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-2/bolt.md +83 -0
  343. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-2/implementation-plan.md +179 -0
  344. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-2/implementation-walkthrough.md +124 -0
  345. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-2/test-walkthrough.md +95 -0
  346. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-3/bolt.md +83 -0
  347. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-3/implementation-plan.md +196 -0
  348. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-3/implementation-walkthrough.md +207 -0
  349. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-3/test-walkthrough.md +194 -0
  350. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-4/bolt.md +92 -0
  351. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-4/implementation-plan.md +217 -0
  352. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-4/implementation-walkthrough.md +138 -0
  353. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-4/test-walkthrough.md +196 -0
  354. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-5/bolt.md +89 -0
  355. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-5/implementation-plan.md +181 -0
  356. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-5/implementation-walkthrough.md +160 -0
  357. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-5/test-walkthrough.md +121 -0
  358. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-welcome-view-1/bolt.md +92 -0
  359. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-welcome-view-1/implementation-plan.md +73 -0
  360. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-welcome-view-1/implementation-walkthrough.md +44 -0
  361. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-welcome-view-1/test-walkthrough.md +49 -0
  362. package/src/iris_bundle/frameworks/iris-core/memory-bank/glossary.md +197 -0
  363. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/requirements.md +129 -0
  364. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/research/approval-gates-simplification.md +839 -0
  365. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/research/archive/approval-gates-analysis.md +331 -0
  366. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/system-context.md +167 -0
  367. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units/construction-agent/unit-brief.md +111 -0
  368. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units/inception-agent/unit-brief.md +135 -0
  369. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units/master-agent/unit-brief.md +580 -0
  370. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units/operations-agent/unit-brief.md +72 -0
  371. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units.md +168 -0
  372. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/requirements.md +96 -0
  373. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/system-context.md +170 -0
  374. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/antigravity-installer/unit-brief.md +156 -0
  375. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/claude-code-installer/unit-brief.md +180 -0
  376. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/cline-installer/unit-brief.md +106 -0
  377. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/codex-installer/unit-brief.md +106 -0
  378. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/copilot-installer/unit-brief.md +139 -0
  379. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/cursor-installer/unit-brief.md +119 -0
  380. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/gemini-installer/unit-brief.md +107 -0
  381. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/installer-core/unit-brief.md +240 -0
  382. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/kilo-installer/unit-brief.md +106 -0
  383. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/kiro-installer/unit-brief.md +108 -0
  384. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/opencode-installer/unit-brief.md +107 -0
  385. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/roo-installer/unit-brief.md +107 -0
  386. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/windsurf-installer/unit-brief.md +128 -0
  387. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units.md +188 -0
  388. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/requirements.md +196 -0
  389. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/system-context.md +181 -0
  390. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/units/artifact-storage/unit-brief.md +192 -0
  391. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/units/configuration-schema/unit-brief.md +204 -0
  392. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/units/context-loader/unit-brief.md +245 -0
  393. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/units.md +97 -0
  394. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/requirements.md +125 -0
  395. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/system-context.md +158 -0
  396. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/units/facilitation-guides/unit-brief.md +250 -0
  397. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/units/standards-catalog/unit-brief.md +355 -0
  398. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/units/standards-templates/unit-brief.md +394 -0
  399. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/units.md +110 -0
  400. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/requirements.md +188 -0
  401. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/system-context.md +229 -0
  402. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/01-specification-contract-testing/unit-brief.md +197 -0
  403. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/02-cli-installer-testing/unit-brief.md +377 -0
  404. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/03-golden-dataset-management/unit-brief.md +465 -0
  405. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/04-agent-behavior-evaluation/unit-brief.md +459 -0
  406. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/05-cicd-integration/unit-brief.md +587 -0
  407. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units.md +332 -0
  408. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/006-brownfield-support/requirements.md +214 -0
  409. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/requirements.md +308 -0
  410. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/system-context.md +335 -0
  411. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/construction-log.md +52 -0
  412. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/001-initialize-mixpanel.md +56 -0
  413. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/002-detect-shell.md +68 -0
  414. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/003-check-telemetry-disabled.md +66 -0
  415. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/004-track-installer-events.md +67 -0
  416. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/005-track-selection-events.md +66 -0
  417. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/006-cli-no-telemetry-flag.md +59 -0
  418. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/unit-brief.md +191 -0
  419. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/002-privacy-documentation/stories/001-create-privacy-md.md +58 -0
  420. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/002-privacy-documentation/stories/002-add-readme-section.md +61 -0
  421. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/002-privacy-documentation/unit-brief.md +158 -0
  422. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units.md +453 -0
  423. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/008-terminal-dashboard/requirements.md +222 -0
  424. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/008-terminal-dashboard/system-context.md +198 -0
  425. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/008-terminal-dashboard/units.md +275 -0
  426. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/009-versioning-strategy/requirements.md +308 -0
  427. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/009-versioning-strategy/system-context.md +273 -0
  428. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/009-versioning-strategy/units.md +312 -0
  429. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/010-smart-unit-decomposition/requirements.md +111 -0
  430. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/010-smart-unit-decomposition/system-context.md +154 -0
  431. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/010-smart-unit-decomposition/units.md +102 -0
  432. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/inception-log.md +101 -0
  433. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/requirements.md +282 -0
  434. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/system-context.md +114 -0
  435. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/construction-log.md +57 -0
  436. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/001-memory-bank-schema.md +56 -0
  437. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/002-project-detection.md +54 -0
  438. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/003-artifact-parsing.md +57 -0
  439. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/004-frontmatter-parser.md +61 -0
  440. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/005-bolt-dependencies.md +58 -0
  441. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/006-activity-feed-derivation.md +70 -0
  442. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/unit-brief.md +223 -0
  443. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/construction-log.md +59 -0
  444. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/stories/001-extension-activation.md +55 -0
  445. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/stories/002-command-registration.md +54 -0
  446. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/stories/003-file-operation-commands.md +57 -0
  447. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/unit-brief.md +224 -0
  448. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/file-watcher/construction-log.md +52 -0
  449. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/file-watcher/stories/001-file-system-watcher.md +57 -0
  450. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/file-watcher/stories/002-debounced-refresh.md +53 -0
  451. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/file-watcher/unit-brief.md +173 -0
  452. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/construction-log.md +63 -0
  453. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/001-tree-data-provider.md +55 -0
  454. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/002-intent-unit-story-tree.md +56 -0
  455. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/003-bolt-tree.md +56 -0
  456. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/004-status-icons.md +55 -0
  457. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/005-pixel-logo-footer.md +55 -0
  458. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/006-webview-tab-architecture.md +62 -0
  459. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/007-command-center-bolts-tab.md +65 -0
  460. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/008-current-focus-card.md +62 -0
  461. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/009-up-next-queue.md +61 -0
  462. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/010-activity-feed-ui.md +63 -0
  463. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/011-filewatcher-statestore-integration.md +49 -0
  464. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/012-next-actions-ui.md +57 -0
  465. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/013-start-bolt-action.md +72 -0
  466. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/014-intent-selection-strategies.md +54 -0
  467. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/015-persist-expanded-state.md +56 -0
  468. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/016-bolt-filtering.md +72 -0
  469. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/017-activity-open-button.md +50 -0
  470. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/018-specs-view.md +63 -0
  471. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/019-overview-view.md +84 -0
  472. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/unit-brief.md +305 -0
  473. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/020-fix-infinite-rerender.md +144 -0
  474. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/021-remove-duplicate-files.md +94 -0
  475. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/022-setup-esbuild.md +156 -0
  476. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/023-lit-scaffold.md +202 -0
  477. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/024-tabs-component.md +161 -0
  478. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/025-bolts-view-components.md +182 -0
  479. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/026-specs-view-components.md +223 -0
  480. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/027-overview-view-components.md +391 -0
  481. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/028-state-context.md +317 -0
  482. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/029-ipc-typed-messaging.md +396 -0
  483. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/unit-brief.md +133 -0
  484. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/construction-log.md +58 -0
  485. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/stories/001-welcome-view-ui.md +57 -0
  486. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/stories/002-install-button-flow.md +55 -0
  487. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/stories/003-post-installation-detection.md +55 -0
  488. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/unit-brief.md +211 -0
  489. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units.md +129 -0
  490. package/src/iris_bundle/frameworks/iris-core/memory-bank/maintenance-log.md +21 -0
  491. package/src/iris_bundle/frameworks/iris-core/memory-bank/project.yaml +16 -0
  492. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/test_strategy/promptfoo-specsmd-tutorial.md +911 -0
  493. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/test_strategy/promptfoo-tutorial.md +796 -0
  494. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/test_strategy/testing-strategy.md +1057 -0
  495. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/unified-modernization-model.md +559 -0
  496. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/vibe-to-production-academic-research.md +578 -0
  497. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/vibe-to-spec-flow-options.md +547 -0
  498. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/coding-standards.md +217 -0
  499. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/output-formatting.md +202 -0
  500. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/skill-template.md +308 -0
  501. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/system-architecture.md +177 -0
  502. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/tech-stack.md +88 -0
  503. package/src/iris_bundle/frameworks/iris-core/memory-bank/story-index.md +154 -0
  504. package/src/iris_bundle/frameworks/iris-core/memory-bank/term-mappings.md +121 -0
  505. package/src/iris_bundle/frameworks/iris-core/pack.yaml +2 -0
  506. package/src/iris_bundle/frameworks/iris-core/package.json +11 -0
  507. package/src/iris_bundle/frameworks/iris-core/policy.yaml +73 -0
  508. package/src/iris_bundle/frameworks/iris-core/resources/ai-dlc-specification.md +286 -0
  509. package/src/iris_bundle/frameworks/iris-core/resources/aidlc.pdf +0 -0
  510. package/src/iris_bundle/frameworks/iris-core/resources/images/aidlc-core-framework.png +0 -0
  511. package/src/iris_bundle/frameworks/iris-core/resources/images/aidlc-phases-detail.png +0 -0
  512. package/src/iris_bundle/frameworks/iris-core/resources/images/aidlc-workflow-steps.png +0 -0
  513. package/src/iris_bundle/frameworks/iris-core/routes.yaml +98 -0
  514. package/src/iris_bundle/frameworks/iris-core/src/README.md +322 -0
  515. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/agent.schema.yaml +20 -0
  516. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/catalog.schema.yaml +60 -0
  517. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/context-config.schema.yaml +24 -0
  518. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/memory-bank.schema.yaml +61 -0
  519. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/skill.schema.yaml +22 -0
  520. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/analytics/analytics.test.ts +240 -0
  521. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/architecture/bolt-type-agnostic.test.ts +282 -0
  522. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/code-examples.test.ts +93 -0
  523. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/helpers.ts +79 -0
  524. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/placeholder-consistency.test.ts +76 -0
  525. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/reference-integrity.test.ts +92 -0
  526. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/terminology-consistency.test.ts +72 -0
  527. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/schema-validation/markdown-schema.test.ts +55 -0
  528. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/schema-validation/yaml-config-schema.test.ts +53 -0
  529. package/src/iris_bundle/frameworks/iris-core/src/bin/cli.js +21 -0
  530. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/README.md +372 -0
  531. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/agents/construction-agent.md +80 -0
  532. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/agents/inception-agent.md +97 -0
  533. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/agents/master-agent.md +61 -0
  534. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/agents/operations-agent.md +89 -0
  535. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/commands/construction-agent.md +63 -0
  536. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/commands/inception-agent.md +55 -0
  537. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/commands/master-agent.md +47 -0
  538. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/commands/operations-agent.md +77 -0
  539. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/context-config.yaml +67 -0
  540. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/memory-bank.yaml +104 -0
  541. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/quick-start.md +322 -0
  542. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/bolt-list.md +163 -0
  543. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/bolt-replan.md +345 -0
  544. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/bolt-start.md +442 -0
  545. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/bolt-status.md +185 -0
  546. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/navigator.md +196 -0
  547. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/bolt-plan.md +372 -0
  548. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/context.md +171 -0
  549. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/intent-create.md +211 -0
  550. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/intent-list.md +124 -0
  551. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/navigator.md +207 -0
  552. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/requirements.md +227 -0
  553. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/review.md +248 -0
  554. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/story-create.md +304 -0
  555. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/units.md +278 -0
  556. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/analyze-context.md +239 -0
  557. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/answer-question.md +141 -0
  558. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/explain-flow.md +158 -0
  559. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/project-init.md +281 -0
  560. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/route-request.md +126 -0
  561. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/build.md +237 -0
  562. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/deploy.md +259 -0
  563. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/monitor.md +265 -0
  564. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/navigator.md +209 -0
  565. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/verify.md +224 -0
  566. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-template.md +226 -0
  567. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt/adr-template.md +49 -0
  568. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-01-domain-model-template.md +55 -0
  569. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-02-technical-design-template.md +67 -0
  570. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-03-test-report-template.md +62 -0
  571. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt.md +528 -0
  572. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/simple-construction-bolt.md +347 -0
  573. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/spike-bolt.md +240 -0
  574. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/construction-log-template.md +129 -0
  575. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/standards/coding-standards.md +29 -0
  576. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/standards/system-architecture.md +22 -0
  577. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/standards/tech-stack.md +19 -0
  578. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/inception-log-template.md +134 -0
  579. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/project/README.md +55 -0
  580. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/requirements-template.md +144 -0
  581. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/stories-template.md +38 -0
  582. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/story-template.md +147 -0
  583. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/system-context-template.md +29 -0
  584. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/unit-brief-template.md +177 -0
  585. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/units-template.md +52 -0
  586. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/standards/catalog.yaml +345 -0
  587. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/standards/coding-standards.guide.md +553 -0
  588. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/standards/data-stack.guide.md +162 -0
  589. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/standards/tech-stack.guide.md +280 -0
  590. package/src/iris_bundle/frameworks/iris-core/src/lib/InstallerFactory.js +36 -0
  591. package/src/iris_bundle/frameworks/iris-core/src/lib/analytics/env-detector.js +92 -0
  592. package/src/iris_bundle/frameworks/iris-core/src/lib/analytics/index.js +22 -0
  593. package/src/iris_bundle/frameworks/iris-core/src/lib/analytics/machine-id.js +33 -0
  594. package/src/iris_bundle/frameworks/iris-core/src/lib/analytics/tracker.js +232 -0
  595. package/src/iris_bundle/frameworks/iris-core/src/lib/cli-utils.js +342 -0
  596. package/src/iris_bundle/frameworks/iris-core/src/lib/constants.js +32 -0
  597. package/src/iris_bundle/frameworks/iris-core/src/lib/installer.js +402 -0
  598. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/AntigravityInstaller.js +22 -0
  599. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/ClaudeInstaller.js +85 -0
  600. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/ClineInstaller.js +21 -0
  601. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/CodexInstaller.js +21 -0
  602. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/CopilotInstaller.js +113 -0
  603. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/CursorInstaller.js +63 -0
  604. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/GeminiInstaller.js +75 -0
  605. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/KiroInstaller.js +22 -0
  606. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/OpenCodeInstaller.js +22 -0
  607. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/RooInstaller.js +22 -0
  608. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/ToolInstaller.js +73 -0
  609. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/WindsurfInstaller.js +76 -0
  610. package/src/iris_bundle/frameworks/iris-core/src/lib/markdown-validator.ts +175 -0
  611. package/src/iris_bundle/frameworks/iris-core/src/lib/yaml-validator.ts +99 -0
  612. package/src/iris_bundle/frameworks/iris-core/src/package-lock.json +9922 -0
  613. package/src/iris_bundle/frameworks/iris-core/src/package.json +118 -0
  614. package/src/iris_bundle/frameworks/iris-core/src/scripts/artifact-validator.js +594 -0
  615. package/src/iris_bundle/frameworks/iris-core/src/scripts/bolt-complete.js +606 -0
  616. package/src/iris_bundle/frameworks/iris-core/src/scripts/status-integrity.js +598 -0
  617. package/src/iris_bundle/frameworks/iris-core/src/specs_md_pixel_logo.png +0 -0
  618. package/src/iris_bundle/frameworks/iris-core/src/tsconfig.json +16 -0
  619. package/src/iris_bundle/frameworks/iris-core/src/vitest.config.ts +12 -0
  620. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/.claude/skills/frontend-design/SKILL.md +42 -0
  621. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/.mocharc.json +5 -0
  622. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/.vscodeignore +17 -0
  623. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/DEVGUIDE.md +103 -0
  624. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/LICENSE +21 -0
  625. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/README.md +198 -0
  626. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/index.html +635 -0
  627. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-1-metrics-dashboard.html +542 -0
  628. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-10-dual-view-focus.html +1105 -0
  629. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-11-dual-view-grouped.html +2304 -0
  630. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-12-dependency-graph.html +1400 -0
  631. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-13-hierarchy-explorer.html +1278 -0
  632. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-14-swimlane-deps.html +1370 -0
  633. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-2-pipeline-flow.html +673 -0
  634. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-3-focus-mode.html +898 -0
  635. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-4-kanban-board.html +858 -0
  636. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-5-timeline.html +890 -0
  637. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-6-activity-feed.html +923 -0
  638. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-7-heatmap-grid.html +932 -0
  639. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-8-2-spec.md +657 -0
  640. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-8-2.html +2098 -0
  641. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-8-command-center.html +2043 -0
  642. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-8a-command-center-timeline.html +1222 -0
  643. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-9-dual-view.html +1101 -0
  644. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/esbuild.webview.mjs +70 -0
  645. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/eslint.config.mjs +36 -0
  646. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/package-lock.json +5712 -0
  647. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/package.json +116 -0
  648. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/extension-preview.png +0 -0
  649. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/extension_icon.svg +40 -0
  650. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/favicon-64.png +0 -0
  651. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/favicon.png +0 -0
  652. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/favicon.svg +40 -0
  653. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/logo.png +0 -0
  654. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/extension.ts +142 -0
  655. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/activityFeed.ts +184 -0
  656. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/artifactParser.ts +477 -0
  657. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/boltTypeParser.ts +191 -0
  658. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/dependencyComputation.ts +157 -0
  659. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/frontmatterParser.ts +144 -0
  660. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/index.ts +93 -0
  661. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/memoryBankSchema.ts +140 -0
  662. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/projectDetection.ts +132 -0
  663. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/types.ts +241 -0
  664. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/iconHelper.ts +82 -0
  665. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/index.ts +85 -0
  666. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/treeBuilder.ts +289 -0
  667. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/treeProvider.ts +225 -0
  668. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/types.ts +254 -0
  669. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/webviewMessaging.ts +306 -0
  670. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/webviewProvider.ts +866 -0
  671. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/state/index.ts +114 -0
  672. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/state/selectors.ts +652 -0
  673. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/state/stateStore.ts +419 -0
  674. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/state/types.ts +311 -0
  675. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/activityFeed.test.ts +269 -0
  676. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/artifactParser.test.ts +440 -0
  677. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/dependencyComputation.test.ts +288 -0
  678. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/frontmatterParser.test.ts +191 -0
  679. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/memoryBankSchema.test.ts +185 -0
  680. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/projectDetection.test.ts +146 -0
  681. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/runTest.ts +20 -0
  682. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/treeBuilder.test.ts +329 -0
  683. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/types.test.ts +239 -0
  684. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/webviewContent.test.ts +67 -0
  685. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/webviewMessaging.test.ts +369 -0
  686. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/webviewProvider.test.ts +282 -0
  687. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/state/selectors.test.ts +457 -0
  688. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/state/stateStore.test.ts +622 -0
  689. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/watcher/debounce.test.ts +155 -0
  690. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/watcher/fileWatcher.test.ts +77 -0
  691. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/watcher/debounce.ts +70 -0
  692. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/watcher/fileWatcher.ts +147 -0
  693. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/watcher/index.ts +39 -0
  694. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/watcher/types.ts +43 -0
  695. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/app.ts +870 -0
  696. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/activity-feed.ts +232 -0
  697. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/activity-item.ts +208 -0
  698. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/bolts-view.ts +201 -0
  699. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/completion-item.ts +299 -0
  700. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/completions-section.ts +197 -0
  701. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/current-bolts.ts +184 -0
  702. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/focus-card.ts +431 -0
  703. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/focus-section.ts +179 -0
  704. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/queue-item.ts +306 -0
  705. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/queue-section.ts +198 -0
  706. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/stories-list.ts +151 -0
  707. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/base-element.ts +29 -0
  708. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/empty-state.ts +82 -0
  709. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/progress-bar.ts +120 -0
  710. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/progress-ring.ts +100 -0
  711. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/stage-pipeline.ts +133 -0
  712. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/tabs/view-tabs.ts +127 -0
  713. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/html.ts +542 -0
  714. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/index.ts +104 -0
  715. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/lit/index.ts +16 -0
  716. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/scripts.ts +241 -0
  717. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/styles/theme.ts +50 -0
  718. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/styles.ts +1194 -0
  719. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/types/messages.ts +40 -0
  720. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/types/vscode.ts +13 -0
  721. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/utils/messaging.ts +57 -0
  722. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/utils.ts +16 -0
  723. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/vscode-api.ts +14 -0
  724. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/welcome/WelcomeViewProvider.ts +254 -0
  725. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/welcome/index.ts +9 -0
  726. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/welcome/installHandler.ts +82 -0
  727. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/tsconfig.json +30 -0
  728. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/tsconfig.test.json +26 -0
  729. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/tsconfig.webview.json +23 -0
@@ -0,0 +1,180 @@
1
+ ---
2
+ title: VS Code Extension
3
+ description: Track your AI-DLC progress with the specsmd sidebar extension
4
+ ---
5
+
6
+ ## Overview
7
+
8
+ The specsmd VS Code extension provides a visual dashboard for tracking your AI-DLC development progress. Monitor bolts, browse specs, and see project metrics—all from your IDE sidebar.
9
+
10
+ <img
11
+ src="/images/extension-preview.png"
12
+ alt="VS Code Extension Preview"
13
+ style={{ borderRadius: '8px', marginBottom: '16px' }}
14
+ />
15
+
16
+ <Info>
17
+ Works with VS Code-based IDEs including [Cursor](https://cursor.sh), [Google Antigravity](https://antigravity.google), [Windsurf](https://codeium.com/windsurf), [GitHub Codespaces](https://github.com/features/codespaces), [Gitpod](https://gitpod.io), and [Amazon Kiro](https://kiro.dev).
18
+ </Info>
19
+
20
+ <Warning>
21
+ **Google IDX is not supported.** While IDX uses Monaco (VS Code's editor), it has a different extension architecture and uses the Open VSX registry instead of the VS Code Marketplace. Many VS Code extensions, including specsmd, don't work or behave differently in IDX.
22
+ </Warning>
23
+
24
+ ## Installation
25
+
26
+ <Tabs>
27
+ <Tab title="VS Code Marketplace">
28
+ Install directly from the marketplace:
29
+
30
+ 1. Open VS Code (or Cursor, Windsurf, etc.)
31
+ 2. Go to Extensions (`Cmd+Shift+X` / `Ctrl+Shift+X`)
32
+ 3. Search for "specsmd"
33
+ 4. Click **Install**
34
+
35
+ Or install via command line:
36
+ ```bash
37
+ code --install-extension fabriqaai.specsmd
38
+ ```
39
+
40
+ <Card
41
+ title="View on Marketplace"
42
+ icon="microsoft"
43
+ href="https://marketplace.visualstudio.com/items?itemName=fabriqaai.specsmd"
44
+ >
45
+ Install from the official VS Code Marketplace
46
+ </Card>
47
+ </Tab>
48
+ <Tab title="Manual Install (VSIX)">
49
+ Download and install the VSIX file manually:
50
+
51
+ 1. Go to [GitHub Releases](https://github.com/fabriqaai/specs.md/releases)
52
+ 2. Download the latest `.vsix` file
53
+ 3. In VS Code, open Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`)
54
+ 4. Run "Extensions: Install from VSIX..."
55
+ 5. Select the downloaded file
56
+
57
+ <Card
58
+ title="GitHub Releases"
59
+ icon="github"
60
+ href="https://github.com/fabriqaai/specs.md/releases"
61
+ >
62
+ Download VSIX for manual installation
63
+ </Card>
64
+ </Tab>
65
+ </Tabs>
66
+
67
+ ## Features
68
+
69
+ The extension provides three main views:
70
+
71
+ ### Bolts Tab
72
+
73
+ Track your bolt execution progress in real-time.
74
+
75
+ <Frame>
76
+ <img src="/images/extension-gallery/bolts.jpeg" alt="Bolts Tab" style={{ borderRadius: '8px' }} />
77
+ </Frame>
78
+
79
+ <AccordionGroup>
80
+ <Accordion title="Current Focus">
81
+ Shows active bolts being worked on with:
82
+ - Bolt name and type (DDD, Simple)
83
+ - Current stage progress
84
+ - Stage pipeline with status indicators
85
+ - Stories list with completion status
86
+ </Accordion>
87
+ <Accordion title="Up Next Queue">
88
+ Shows pending bolts ready to be started:
89
+ - Unblocked bolts first (higher priority)
90
+ - Blocked bolts with dependency info
91
+ - Quick start button for each bolt
92
+ </Accordion>
93
+ <Accordion title="Recent Activity">
94
+ Timeline of bolt and stage completions:
95
+ - Filterable by All, Stages, or Bolts
96
+ - Relative timestamps
97
+ - Click to navigate to files
98
+ </Accordion>
99
+ </AccordionGroup>
100
+
101
+ ### Specs Tab
102
+
103
+ Browse your project specifications hierarchically.
104
+
105
+ <Frame>
106
+ <img src="/images/extension-gallery/specs.jpeg" alt="Specs Tab" style={{ borderRadius: '8px' }} />
107
+ </Frame>
108
+
109
+ - **Intents** - High-level goals with progress indicators
110
+ - **Units** - Cohesive work elements within intents
111
+ - **Stories** - Individual user stories with status
112
+
113
+ Click any item to open its markdown file.
114
+
115
+ ### Overview Tab
116
+
117
+ High-level project metrics and quick actions.
118
+
119
+ <Frame>
120
+ <img src="/images/extension-gallery/overview.jpeg" alt="Overview Tab" style={{ borderRadius: '8px' }} />
121
+ </Frame>
122
+
123
+ - **Progress** - Overall completion percentage
124
+ - **Stats** - Active, queued, done, and blocked bolts
125
+ - **Suggested Actions** - AI-recommended next steps
126
+ - **Standards** - Quick access to project standards
127
+
128
+ ## Activation
129
+
130
+ The extension automatically activates when it detects:
131
+ - A `memory-bank/` folder in your workspace
132
+ - A `.specsmd/` folder in your workspace
133
+
134
+ <Note>
135
+ Make sure you've run `npx specsmd@latest install` first to set up your project structure.
136
+ </Note>
137
+
138
+ ## Refreshing Data
139
+
140
+ The extension watches your memory-bank files for changes. To manually refresh:
141
+ - Click the refresh icon in the sidebar header
142
+ - Or use Command Palette: "specsmd: Refresh"
143
+
144
+ ## Troubleshooting
145
+
146
+ <AccordionGroup>
147
+ <Accordion title="Extension not showing in sidebar">
148
+ Ensure your workspace has a `memory-bank/` or `.specsmd/` folder. The extension only activates when these are present.
149
+
150
+ ```bash
151
+ # Initialize specs.md first
152
+ npx specsmd@latest install
153
+ ```
154
+ </Accordion>
155
+ <Accordion title="Data not updating">
156
+ Click the refresh icon in the sidebar header, or check that your memory-bank files are saved.
157
+ </Accordion>
158
+ <Accordion title="Extension not working in Cursor/Windsurf">
159
+ The extension is compatible with VS Code-based IDEs. Make sure you're installing from the VS Code Marketplace or using a compatible VSIX.
160
+ </Accordion>
161
+ </AccordionGroup>
162
+
163
+ ## Next Steps
164
+
165
+ <CardGroup cols={2}>
166
+ <Card
167
+ title="Quick Start"
168
+ icon="rocket"
169
+ href="/getting-started/quick-start"
170
+ >
171
+ Initialize your project and create your first Intent
172
+ </Card>
173
+ <Card
174
+ title="Core Concepts"
175
+ icon="cube"
176
+ href="/core-concepts/bolts"
177
+ >
178
+ Learn about Bolts and how to track them
179
+ </Card>
180
+ </CardGroup>
@@ -0,0 +1,182 @@
1
+ ---
2
+ title: Choosing Bolt Types
3
+ description: A practical guide to selecting the right bolt type for your work
4
+ ---
5
+
6
+ ## Overview
7
+
8
+ The AI-DLC flow in specs.md provides two bolt types, each optimized for different types of work. Choosing the right bolt type ensures you have the appropriate level of rigor and structure for your task.
9
+
10
+ ```mermaid
11
+ flowchart LR
12
+ subgraph DDD[DDD Construction]
13
+ D1[Complex domain logic]
14
+ D2[Business rules]
15
+ D3[5 stages - Most rigorous]
16
+ end
17
+
18
+ subgraph Simple[Simple Construction]
19
+ S1[UI, integrations]
20
+ S2[Utilities, CRUD]
21
+ S3[3 stages - Lightweight]
22
+ end
23
+
24
+ style DDD fill:#8B5CF6,stroke:#7C3AED,color:#fff
25
+ style Simple fill:#34D399,stroke:#10B981,color:#fff
26
+ ```
27
+
28
+ ## Quick Decision Guide
29
+
30
+ <Info>
31
+ The Inception Agent automatically selects the appropriate bolt type based on your requirements. If you disagree with its choice, you can change it during the human checkpoint review.
32
+ </Info>
33
+
34
+ <Steps>
35
+ <Step title="Does it involve complex business logic or domain rules?">
36
+ **Yes** → Use **DDD Construction Bolt**
37
+
38
+ **No** → Continue to next question
39
+ </Step>
40
+ <Step title="Is it UI, integration, utility, or straightforward CRUD?">
41
+ **Yes** → Use **Simple Construction Bolt**
42
+ </Step>
43
+ </Steps>
44
+
45
+ ---
46
+
47
+ ## DDD Construction Bolt
48
+
49
+ <Card title="When to Use" icon="bullseye">
50
+ Complex domain logic requiring careful modeling and design decisions.
51
+ </Card>
52
+
53
+ ### Best For
54
+
55
+ - Core business logic with complex rules
56
+ - Domain models with aggregates, entities, and value objects
57
+ - Services that encode business knowledge
58
+ - Features where incorrect logic has significant consequences
59
+ - Bounded contexts with rich domain models
60
+
61
+ ### Stages
62
+
63
+ | Stage | Purpose | Output |
64
+ |-------|---------|--------|
65
+ | **1. Domain Model** | Model business logic using DDD principles | Domain model document |
66
+ | **2. Technical Design** | Apply patterns, define interfaces | Technical design document |
67
+ | **3. ADR Analysis** | Document significant decisions | Architecture Decision Record |
68
+ | **4. Implement** | Generate production code | Implementation |
69
+ | **5. Test** | Verify correctness | Test suite |
70
+
71
+ ### Example Use Cases
72
+
73
+ <AccordionGroup>
74
+ <Accordion title="E-commerce Order Processing">
75
+ Orders involve complex state transitions, pricing rules, inventory checks, and payment processing. DDD helps model these business rules explicitly.
76
+ </Accordion>
77
+ <Accordion title="Financial Calculations">
78
+ Interest calculations, fee structures, and compliance rules require careful domain modeling to ensure correctness.
79
+ </Accordion>
80
+ <Accordion title="Booking Systems">
81
+ Availability rules, conflict detection, and reservation logic benefit from explicit domain modeling.
82
+ </Accordion>
83
+ <Accordion title="Workflow Engines">
84
+ State machines, transition rules, and approval chains require careful design.
85
+ </Accordion>
86
+ </AccordionGroup>
87
+
88
+ ---
89
+
90
+ ## Simple Construction Bolt
91
+
92
+ <Card title="When to Use" icon="feather">
93
+ Straightforward implementations that don't require extensive domain modeling.
94
+ </Card>
95
+
96
+ ### Best For
97
+
98
+ - Frontend pages and components
99
+ - Simple CRUD endpoints
100
+ - External API integrations
101
+ - Utilities and helper modules
102
+ - CLI commands and scripts
103
+ - Configuration and setup code
104
+
105
+ ### Stages
106
+
107
+ | Stage | Purpose | Output |
108
+ |-------|---------|--------|
109
+ | **1. Plan** | Define what to build | `implementation-plan.md` |
110
+ | **2. Implement** | Write the code | Source code + `implementation-walkthrough.md` |
111
+ | **3. Test** | Verify the implementation | Tests + `test-walkthrough.md` |
112
+
113
+ ### Example Use Cases
114
+
115
+ <AccordionGroup>
116
+ <Accordion title="User Profile Page">
117
+ A React component displaying user information with edit capabilities. Clear requirements, no complex business logic.
118
+ </Accordion>
119
+ <Accordion title="REST API Integration">
120
+ Connecting to a third-party API with well-documented endpoints. Focus on correct integration, not domain modeling.
121
+ </Accordion>
122
+ <Accordion title="Admin Dashboard">
123
+ Data display and basic filtering. CRUD operations with straightforward UI.
124
+ </Accordion>
125
+ <Accordion title="CLI Tool">
126
+ A command-line utility for common operations. Clear inputs and outputs.
127
+ </Accordion>
128
+ </AccordionGroup>
129
+
130
+ ---
131
+
132
+ ## Comparison Table
133
+
134
+ | Aspect | DDD Construction | Simple Construction |
135
+ |--------|------------------|---------------------|
136
+ | **Stages** | 5 | 3 |
137
+ | **Duration** | Hours to days | Hours |
138
+ | **Documentation** | Extensive | Light |
139
+ | **Design Rigor** | High | Low |
140
+ | **Output** | Production code + artifacts | Production code |
141
+ | **Human Reviews** | 5 checkpoint reviews | 3 checkpoint reviews |
142
+
143
+ ## Common Mistakes
144
+
145
+ <Warning>
146
+ Choosing the wrong bolt type leads to either over-engineering simple tasks or under-designing complex ones.
147
+ </Warning>
148
+
149
+ ### Over-Engineering (DDD for Simple Tasks)
150
+
151
+ **Symptom**: Using DDD Construction for a simple settings page.
152
+
153
+ **Problem**: Excessive ceremony for straightforward work. Domain modeling for CRUD operations wastes time without adding value.
154
+
155
+ **Solution**: Use Simple Construction for UI, utilities, and integrations.
156
+
157
+ ### Under-Engineering (Simple for Complex Tasks)
158
+
159
+ **Symptom**: Using Simple Construction for complex pricing logic.
160
+
161
+ **Problem**: Skipping domain modeling leads to implicit business rules scattered in code. Bugs emerge as edge cases are missed.
162
+
163
+ **Solution**: Use DDD Construction when business logic is non-trivial.
164
+
165
+ ## Next Steps
166
+
167
+ <CardGroup cols={2}>
168
+ <Card
169
+ title="Bolts Overview"
170
+ icon="arrow-right"
171
+ href="/core-concepts/bolts"
172
+ >
173
+ Core concepts and bolt mechanics
174
+ </Card>
175
+ <Card
176
+ title="Construction Agent"
177
+ icon="hammer"
178
+ href="/agents/construction-agent"
179
+ >
180
+ Learn how the agent executes bolts
181
+ </Card>
182
+ </CardGroup>
@@ -0,0 +1,129 @@
1
+ <svg width="800" height="420" viewBox="0 0 800 420" fill="none" xmlns="http://www.w3.org/2000/svg">
2
+ <!-- Background -->
3
+ <rect width="800" height="420" fill="#0F172A"/>
4
+
5
+ <!-- Title -->
6
+ <text x="400" y="35" font-family="system-ui, -apple-system, sans-serif" font-size="22" font-weight="700" fill="#F8FAFC" text-anchor="middle">specs.md Framework</text>
7
+ <text x="400" y="55" font-family="system-ui, -apple-system, sans-serif" font-size="12" fill="#94A3B8" text-anchor="middle">Spec-Driven AI Development with Pluggable Flows</text>
8
+
9
+ <!-- Framework Box -->
10
+ <g transform="translate(50, 75)">
11
+ <!-- Main framework container -->
12
+ <rect width="700" height="310" rx="16" fill="#1E293B" stroke="#334155" stroke-width="2"/>
13
+ <rect width="700" height="40" rx="16" fill="#0F172A"/>
14
+ <rect x="0" y="28" width="700" height="12" fill="#0F172A"/>
15
+ <text x="350" y="26" font-family="system-ui, sans-serif" font-size="14" font-weight="600" fill="#F8FAFC" text-anchor="middle">specs.md Framework - Pluggable Flows</text>
16
+
17
+ <!-- AI-DLC Flow (Active) -->
18
+ <g transform="translate(20, 55)">
19
+ <rect width="440" height="235" rx="10" fill="#052E16" stroke="#22C55E" stroke-width="2"/>
20
+ <rect width="440" height="32" rx="10" fill="#22C55E"/>
21
+ <rect x="0" y="22" width="440" height="10" fill="#22C55E"/>
22
+ <text x="220" y="22" font-family="system-ui, sans-serif" font-size="12" font-weight="600" fill="white" text-anchor="middle">AI-DLC Flow (First Implemented)</text>
23
+
24
+ <!-- Three phases row -->
25
+ <g transform="translate(15, 45)">
26
+ <text x="205" y="12" font-family="system-ui, sans-serif" font-size="9" font-weight="500" fill="#86EFAC" text-anchor="middle">PHASES</text>
27
+ <g transform="translate(0, 20)">
28
+ <rect width="130" height="28" rx="4" fill="#818CF8"/>
29
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="10" fill="white" text-anchor="middle">Inception</text>
30
+ </g>
31
+ <g transform="translate(140, 20)">
32
+ <rect width="130" height="28" rx="4" fill="#34D399"/>
33
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="10" fill="white" text-anchor="middle">Construction</text>
34
+ </g>
35
+ <g transform="translate(280, 20)">
36
+ <rect width="130" height="28" rx="4" fill="#FBBF24"/>
37
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="10" fill="white" text-anchor="middle">Operations</text>
38
+ </g>
39
+ </g>
40
+
41
+ <!-- Core components -->
42
+ <g transform="translate(15, 105)">
43
+ <text x="205" y="12" font-family="system-ui, sans-serif" font-size="9" font-weight="500" fill="#86EFAC" text-anchor="middle">CORE COMPONENTS</text>
44
+ <g transform="translate(0, 20)">
45
+ <rect width="80" height="28" rx="4" fill="#0C4A6E" stroke="#0EA5E9"/>
46
+ <text x="40" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#7DD3FC" text-anchor="middle">Memory Bank</text>
47
+ </g>
48
+ <g transform="translate(85, 20)">
49
+ <rect width="80" height="28" rx="4" fill="#0C4A6E" stroke="#0EA5E9"/>
50
+ <text x="40" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#7DD3FC" text-anchor="middle">Standards</text>
51
+ </g>
52
+ <g transform="translate(170, 20)">
53
+ <rect width="80" height="28" rx="4" fill="#0C4A6E" stroke="#0EA5E9"/>
54
+ <text x="40" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#7DD3FC" text-anchor="middle">Agent System</text>
55
+ </g>
56
+ <g transform="translate(255, 20)">
57
+ <rect width="75" height="28" rx="4" fill="#0C4A6E" stroke="#0EA5E9"/>
58
+ <text x="37" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#7DD3FC" text-anchor="middle">Templates</text>
59
+ </g>
60
+ <g transform="translate(335, 20)">
61
+ <rect width="75" height="28" rx="4" fill="#0C4A6E" stroke="#0EA5E9"/>
62
+ <text x="37" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#7DD3FC" text-anchor="middle">Commands</text>
63
+ </g>
64
+ </g>
65
+
66
+ <!-- Bolt types -->
67
+ <g transform="translate(15, 165)">
68
+ <text x="205" y="12" font-family="system-ui, sans-serif" font-size="9" font-weight="500" fill="#86EFAC" text-anchor="middle">BOLT TYPES</text>
69
+ <g transform="translate(0, 20)">
70
+ <rect width="130" height="28" rx="4" fill="#14532D" stroke="#22C55E"/>
71
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="9" fill="#86EFAC" text-anchor="middle">DDD Construction</text>
72
+ </g>
73
+ <g transform="translate(140, 20)">
74
+ <rect width="130" height="28" rx="4" fill="#14532D" stroke="#22C55E"/>
75
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="9" fill="#86EFAC" text-anchor="middle">Simple Construction</text>
76
+ </g>
77
+ <g transform="translate(280, 20)">
78
+ <rect width="130" height="28" rx="4" fill="#1E293B" stroke="#475569" stroke-dasharray="4 2"/>
79
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="9" fill="#64748B" text-anchor="middle">Future Bolt Types...</text>
80
+ </g>
81
+ </g>
82
+ </g>
83
+
84
+ <!-- Future Flows Section -->
85
+ <g transform="translate(480, 55)">
86
+ <rect width="200" height="235" rx="10" fill="#1E293B" stroke="#475569" stroke-dasharray="4 2"/>
87
+ <text x="100" y="25" font-family="system-ui, sans-serif" font-size="11" font-weight="600" fill="#64748B" text-anchor="middle">Future Flows</text>
88
+
89
+ <!-- Future Flow Placeholder 1 -->
90
+ <g transform="translate(15, 45)">
91
+ <rect width="170" height="55" rx="8" fill="#1E293B" stroke="#475569" stroke-dasharray="4 2"/>
92
+ <text x="85" y="32" font-family="system-ui, sans-serif" font-size="10" fill="#64748B" text-anchor="middle">Custom Flow 1</text>
93
+ </g>
94
+
95
+ <!-- Future Flow Placeholder 2 -->
96
+ <g transform="translate(15, 115)">
97
+ <rect width="170" height="55" rx="8" fill="#1E293B" stroke="#475569" stroke-dasharray="4 2"/>
98
+ <text x="85" y="32" font-family="system-ui, sans-serif" font-size="10" fill="#64748B" text-anchor="middle">Custom Flow 2</text>
99
+ </g>
100
+
101
+ <!-- Tool integrations -->
102
+ <g transform="translate(15, 185)">
103
+ <text x="85" y="10" font-family="system-ui, sans-serif" font-size="9" font-weight="500" fill="#94A3B8" text-anchor="middle">Tool Integrations</text>
104
+ <g transform="translate(0, 18)">
105
+ <rect width="40" height="22" rx="4" fill="#1E293B" stroke="#475569"/>
106
+ <text x="20" y="15" font-family="system-ui, sans-serif" font-size="7" fill="#94A3B8" text-anchor="middle">Claude</text>
107
+ </g>
108
+ <g transform="translate(45, 18)">
109
+ <rect width="40" height="22" rx="4" fill="#1E293B" stroke="#475569"/>
110
+ <text x="20" y="15" font-family="system-ui, sans-serif" font-size="7" fill="#94A3B8" text-anchor="middle">Cursor</text>
111
+ </g>
112
+ <g transform="translate(90, 18)">
113
+ <rect width="40" height="22" rx="4" fill="#1E293B" stroke="#475569"/>
114
+ <text x="20" y="15" font-family="system-ui, sans-serif" font-size="7" fill="#94A3B8" text-anchor="middle">Copilot</text>
115
+ </g>
116
+ <g transform="translate(135, 18)">
117
+ <rect width="35" height="22" rx="4" fill="#1E293B" stroke="#475569"/>
118
+ <text x="17" y="15" font-family="system-ui, sans-serif" font-size="7" fill="#94A3B8" text-anchor="middle">...</text>
119
+ </g>
120
+ </g>
121
+ </g>
122
+ </g>
123
+
124
+ <!-- Bottom tagline -->
125
+ <g transform="translate(50, 400)">
126
+ <rect width="220" height="16" rx="4" fill="#422006"/>
127
+ <text x="110" y="12" font-family="system-ui, sans-serif" font-size="9" fill="#FDE68A" text-anchor="middle">AI Proposes - Human Validates - AI Executes</text>
128
+ </g>
129
+ </svg>
@@ -0,0 +1,129 @@
1
+ <svg width="800" height="420" viewBox="0 0 800 420" fill="none" xmlns="http://www.w3.org/2000/svg">
2
+ <!-- Background -->
3
+ <rect width="800" height="420" fill="#FAFAFA"/>
4
+
5
+ <!-- Title -->
6
+ <text x="400" y="35" font-family="system-ui, -apple-system, sans-serif" font-size="22" font-weight="700" fill="#1a1a1a" text-anchor="middle">specs.md Framework</text>
7
+ <text x="400" y="55" font-family="system-ui, -apple-system, sans-serif" font-size="12" fill="#666" text-anchor="middle">Spec-Driven AI Development with Pluggable Flows</text>
8
+
9
+ <!-- Framework Box -->
10
+ <g transform="translate(50, 75)">
11
+ <!-- Main framework container -->
12
+ <rect width="700" height="310" rx="16" fill="white" stroke="#E2E8F0" stroke-width="2"/>
13
+ <rect width="700" height="40" rx="16" fill="#1E293B"/>
14
+ <rect x="0" y="28" width="700" height="12" fill="#1E293B"/>
15
+ <text x="350" y="26" font-family="system-ui, sans-serif" font-size="14" font-weight="600" fill="white" text-anchor="middle">specs.md Framework - Pluggable Flows</text>
16
+
17
+ <!-- AI-DLC Flow (Active) -->
18
+ <g transform="translate(20, 55)">
19
+ <rect width="440" height="235" rx="10" fill="#F0FDF4" stroke="#22C55E" stroke-width="2"/>
20
+ <rect width="440" height="32" rx="10" fill="#22C55E"/>
21
+ <rect x="0" y="22" width="440" height="10" fill="#22C55E"/>
22
+ <text x="220" y="22" font-family="system-ui, sans-serif" font-size="12" font-weight="600" fill="white" text-anchor="middle">AI-DLC Flow (First Implemented)</text>
23
+
24
+ <!-- Three phases row -->
25
+ <g transform="translate(15, 45)">
26
+ <text x="205" y="12" font-family="system-ui, sans-serif" font-size="9" font-weight="500" fill="#166534" text-anchor="middle">PHASES</text>
27
+ <g transform="translate(0, 20)">
28
+ <rect width="130" height="28" rx="4" fill="#818CF8"/>
29
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="10" fill="white" text-anchor="middle">Inception</text>
30
+ </g>
31
+ <g transform="translate(140, 20)">
32
+ <rect width="130" height="28" rx="4" fill="#34D399"/>
33
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="10" fill="white" text-anchor="middle">Construction</text>
34
+ </g>
35
+ <g transform="translate(280, 20)">
36
+ <rect width="130" height="28" rx="4" fill="#FBBF24"/>
37
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="10" fill="white" text-anchor="middle">Operations</text>
38
+ </g>
39
+ </g>
40
+
41
+ <!-- Core components -->
42
+ <g transform="translate(15, 105)">
43
+ <text x="205" y="12" font-family="system-ui, sans-serif" font-size="9" font-weight="500" fill="#166534" text-anchor="middle">CORE COMPONENTS</text>
44
+ <g transform="translate(0, 20)">
45
+ <rect width="80" height="28" rx="4" fill="#E0F2FE" stroke="#7DD3FC"/>
46
+ <text x="40" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#0369A1" text-anchor="middle">Memory Bank</text>
47
+ </g>
48
+ <g transform="translate(85, 20)">
49
+ <rect width="80" height="28" rx="4" fill="#E0F2FE" stroke="#7DD3FC"/>
50
+ <text x="40" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#0369A1" text-anchor="middle">Standards</text>
51
+ </g>
52
+ <g transform="translate(170, 20)">
53
+ <rect width="80" height="28" rx="4" fill="#E0F2FE" stroke="#7DD3FC"/>
54
+ <text x="40" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#0369A1" text-anchor="middle">Agent System</text>
55
+ </g>
56
+ <g transform="translate(255, 20)">
57
+ <rect width="75" height="28" rx="4" fill="#E0F2FE" stroke="#7DD3FC"/>
58
+ <text x="37" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#0369A1" text-anchor="middle">Templates</text>
59
+ </g>
60
+ <g transform="translate(335, 20)">
61
+ <rect width="75" height="28" rx="4" fill="#E0F2FE" stroke="#7DD3FC"/>
62
+ <text x="37" y="18" font-family="system-ui, sans-serif" font-size="8" fill="#0369A1" text-anchor="middle">Commands</text>
63
+ </g>
64
+ </g>
65
+
66
+ <!-- Bolt types -->
67
+ <g transform="translate(15, 165)">
68
+ <text x="205" y="12" font-family="system-ui, sans-serif" font-size="9" font-weight="500" fill="#166534" text-anchor="middle">BOLT TYPES</text>
69
+ <g transform="translate(0, 20)">
70
+ <rect width="130" height="28" rx="4" fill="#DCFCE7" stroke="#22C55E"/>
71
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="9" fill="#166534" text-anchor="middle">DDD Construction</text>
72
+ </g>
73
+ <g transform="translate(140, 20)">
74
+ <rect width="130" height="28" rx="4" fill="#DCFCE7" stroke="#22C55E"/>
75
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="9" fill="#166534" text-anchor="middle">Simple Construction</text>
76
+ </g>
77
+ <g transform="translate(280, 20)">
78
+ <rect width="130" height="28" rx="4" fill="#F1F5F9" stroke="#CBD5E1" stroke-dasharray="4 2"/>
79
+ <text x="65" y="18" font-family="system-ui, sans-serif" font-size="9" fill="#94A3B8" text-anchor="middle">Future Bolt Types...</text>
80
+ </g>
81
+ </g>
82
+ </g>
83
+
84
+ <!-- Future Flows Section -->
85
+ <g transform="translate(480, 55)">
86
+ <rect width="200" height="235" rx="10" fill="#F8FAFC" stroke="#CBD5E1" stroke-dasharray="4 2"/>
87
+ <text x="100" y="25" font-family="system-ui, sans-serif" font-size="11" font-weight="600" fill="#94A3B8" text-anchor="middle">Future Flows</text>
88
+
89
+ <!-- Future Flow Placeholder 1 -->
90
+ <g transform="translate(15, 45)">
91
+ <rect width="170" height="55" rx="8" fill="#F1F5F9" stroke="#CBD5E1" stroke-dasharray="4 2"/>
92
+ <text x="85" y="32" font-family="system-ui, sans-serif" font-size="10" fill="#94A3B8" text-anchor="middle">Custom Flow 1</text>
93
+ </g>
94
+
95
+ <!-- Future Flow Placeholder 2 -->
96
+ <g transform="translate(15, 115)">
97
+ <rect width="170" height="55" rx="8" fill="#F1F5F9" stroke="#CBD5E1" stroke-dasharray="4 2"/>
98
+ <text x="85" y="32" font-family="system-ui, sans-serif" font-size="10" fill="#94A3B8" text-anchor="middle">Custom Flow 2</text>
99
+ </g>
100
+
101
+ <!-- Tool integrations -->
102
+ <g transform="translate(15, 185)">
103
+ <text x="85" y="10" font-family="system-ui, sans-serif" font-size="9" font-weight="500" fill="#475569" text-anchor="middle">Tool Integrations</text>
104
+ <g transform="translate(0, 18)">
105
+ <rect width="40" height="22" rx="4" fill="#F1F5F9" stroke="#E2E8F0"/>
106
+ <text x="20" y="15" font-family="system-ui, sans-serif" font-size="7" fill="#64748B" text-anchor="middle">Claude</text>
107
+ </g>
108
+ <g transform="translate(45, 18)">
109
+ <rect width="40" height="22" rx="4" fill="#F1F5F9" stroke="#E2E8F0"/>
110
+ <text x="20" y="15" font-family="system-ui, sans-serif" font-size="7" fill="#64748B" text-anchor="middle">Cursor</text>
111
+ </g>
112
+ <g transform="translate(90, 18)">
113
+ <rect width="40" height="22" rx="4" fill="#F1F5F9" stroke="#E2E8F0"/>
114
+ <text x="20" y="15" font-family="system-ui, sans-serif" font-size="7" fill="#64748B" text-anchor="middle">Copilot</text>
115
+ </g>
116
+ <g transform="translate(135, 18)">
117
+ <rect width="35" height="22" rx="4" fill="#F1F5F9" stroke="#E2E8F0"/>
118
+ <text x="17" y="15" font-family="system-ui, sans-serif" font-size="7" fill="#64748B" text-anchor="middle">...</text>
119
+ </g>
120
+ </g>
121
+ </g>
122
+ </g>
123
+
124
+ <!-- Bottom tagline -->
125
+ <g transform="translate(50, 400)">
126
+ <rect width="220" height="16" rx="4" fill="#FEF3C7"/>
127
+ <text x="110" y="12" font-family="system-ui, sans-serif" font-size="9" fill="#92400E" text-anchor="middle">AI Proposes - Human Validates - AI Executes</text>
128
+ </g>
129
+ </svg>