project-iris 0.0.1

package/src/iris_bundle/frameworks/iris-core/README.md

@@ -0,0 +1,397 @@
+# iris.md
+
+<p align="center">
+  <img src="images/specs_md_pixel_logo.png" alt="iris.md logo" width="400" />
+</p>
+
+**AI-native software development with multi-agent orchestration.**
+
+irismd implements the [AI-Driven Development Lifecycle (AI-DLC)](https://aws.amazon.com/blogs/devops/ai-driven-development-life-cycle/) methodology as a set of markdown-based agents that work with your favorite AI coding tools.
+
+[![npm version](https://img.shields.io/npm/v/irismd)](https://www.npmjs.com/package/irismd)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Documentation](https://img.shields.io/badge/docs-iris.md-CD6B4D)](https://iris.md)
+
+<p align="center">
+  <img src="docs.iris.md/images/quickstart.gif" alt="iris.md demo" width="800" />
+</p>
+
+---
+
+## VS Code Extension
+
+Track your AI-DLC progress with our sidebar extension for VS Code and compatible IDEs.
+
+<p align="center">
+  <img src="vs-code-extension/resources/extension-preview.png" alt="VS Code Extension Preview" width="800" />
+</p>
+
+> **Note:** Works with any VS Code-based IDE including [Cursor](https://cursor.sh), [Google Antigravity](https://antigravity.google), [Windsurf](https://codeium.com/windsurf), and others.
+
+**Install from:**
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=fabriqaai.irismd)
+- [GitHub Releases (VSIX)](https://github.com/fabriqaai/iris.md/releases)
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js 18 or higher
+- An AI coding tool (Claude Code, Cursor, GitHub Copilot, or Google Antigravity)
+
+### Installation
+
+> [!NOTE]
+> Do not use npm if you want to always get the latest version. Use the npx command below.
+
+```bash
+npx irismd@latest install
+```
+
+The installer detects your AI coding tools (Claude Code, Cursor, GitHub Copilot) and sets up:
+- Agent definitions and skills
+- Memory bank structure for context persistence
+- Slash commands for easy agent invocation
+
+### Verify Installation
+
+```bash
+# Check the manifest
+cat .irismd/manifest.yaml
+
+# List installed agents
+ls .irismd/aidlc/agents/
+```
+
+### Initialize Your Project
+Open your AI Assisted Tool (Claude Code, Cursor, GitHub Copilot) and run the following commands:
+
+```bash
+# Start the Master Agent
+/irismd-master-agent
+
+# Then type:
+project-init
+```
+
+This guides you through establishing:
+- **Tech Stack** - Languages, frameworks, databases, infrastructure
+- **Coding Standards** - Formatting, linting, naming, testing strategy
+- **System Architecture** - Architecture style, API design, state management
+- **UX Guide** - Design system, styling, accessibility (optional)
+- **API Conventions** - API style, versioning, response formats (optional)
+
+### Create Your First Intent
+
+```bash
+/irismd-inception-agent intent-create
+```
+
+An **Intent** is your high-level goal:
+- "User authentication system"
+- "Product catalog with search"
+- "Payment processing integration"
+
+The agent will:
+1. Ask clarifying questions to minimize ambiguity
+2. Elaborate into user stories and NFRs
+3. Define system context
+4. Decompose into loosely-coupled units
+
+### Plan and Execute Bolts
+
+```bash
+# Plan bolts for your stories
+/irismd-inception-agent bolt-plan
+
+# Execute a bolt
+/irismd-construction-agent bolt-start
+```
+
+Each bolt goes through validated stages:
+1. **Domain Model** - Model business logic using DDD principles
+2. **Technical Design** - Apply patterns and make architecture decisions
+3. **ADR Analysis** - Document significant decisions (optional)
+4. **Implement** - Generate production code
+5. **Test** - Verify correctness with automated tests
+
+**Human validation happens at each stage gate.**
+
+---
+
+## What is AI-DLC?
+
+AI-DLC is a reimagined software development methodology where **AI drives the conversation** and humans validate. Unlike traditional Agile where iterations span weeks, AI-DLC operates in **Bolts** - rapid iterations measured in hours or days.
+
+> "Traditional development methods were built for human-driven, long-running processes. AI-DLC reimagines the development lifecycle with AI as a central collaborator, enabling rapid cycles measured in hours or days rather than weeks."
+
+### AI-DLC vs Traditional Methods
+
+| Aspect | Agile/Scrum | AI-DLC |
+|--------|-------------|--------|
+| Iteration duration | Weeks (Sprints) | Hours/days (Bolts) |
+| Who drives | Human-driven, AI assists | AI-driven, human-validated |
+| Design techniques | Out of scope | Integrated (DDD, TDD, BDD) |
+| Task decomposition | Manual | AI-powered |
+| Phases | Repeating sprints | Rapid three-phase cycles (Inception → Construction → Operations) |
+| Rituals | Daily standups, retrospectives | Mob Elaboration, Mob Construction |
+
+---
+
+## How It Works
+
+irismd provides four specialized agents that guide you through the entire development lifecycle:
+
+```mermaid
+flowchart TB
+    MA[Master Agent<br/>Orchestrates & Navigates] --> IA[Inception Agent]
+    MA --> CA[Construction Agent]
+    MA --> OA[Operations Agent]
+
+    IA --> CA --> OA
+
+    style MA fill:#8B5CF6,stroke:#7C3AED,color:#fff
+    style IA fill:#818CF8,stroke:#6366F1,color:#fff
+    style CA fill:#34D399,stroke:#10B981,color:#fff
+    style OA fill:#FBBF24,stroke:#F59E0B,color:#fff
+```
+
+### The Three Phases
+
+| Phase | Agent | Purpose | Key Outputs |
+|-------|-------|---------|-------------|
+| **Inception** | Inception Agent | Capture intents, elaborate requirements, decompose into units | User stories, NFRs, Unit definitions, Bolt plans |
+| **Construction** | Construction Agent | Execute bolts through domain design → logical design → code → test | Domain models, Technical designs, Code, Tests |
+| **Operations** | Operations Agent | Deploy, verify, and monitor | Deployment units, Monitoring, Runbooks |
+
+---
+
+## Key Concepts
+
+### Intent
+A high-level statement of purpose that encapsulates what needs to be achieved - whether a business goal, feature, or technical outcome. It serves as the starting point for AI-driven decomposition.
+
+### Unit
+A cohesive, self-contained work element derived from an Intent. Units are loosely coupled and can be developed independently. Analogous to a Subdomain (DDD) or Epic (Scrum).
+
+### Bolt
+The smallest iteration in AI-DLC, designed for rapid implementation. Unlike Sprints (weeks), Bolts are **hours to days**. Each bolt encapsulates a well-defined scope of work.
+
+| Type | Best For | Stages |
+|------|----------|--------|
+| **DDD Construction** | Complex business logic, domain modeling | Model → Design → ADR → Implement → Test |
+| **Simple Construction** | UI, integrations, utilities | Plan → Implement → Test |
+
+### Memory Bank
+File-based storage for all project artifacts. Maintains context across agent sessions and provides traceability between artifacts.
+
+### Standards
+Project decisions that inform AI code generation. Standards ensure consistency across all generated code and documentation.
+
+---
+
+<details>
+<summary><h2>Project Structure</h2></summary>
+
+After installation:
+
+```
+.irismd/
+├── manifest.yaml              # Installation manifest
+└── aidlc/                     # AI-DLC flow
+    ├── agents/                # Agent definitions
+    ├── skills/                # Agent capabilities
+    ├── templates/             # Artifact templates
+    │   └── standards/         # Standards facilitation guides
+    └── memory-bank.yaml       # Memory bank schema
+
+memory-bank/                   # Created after project-init
+├── intents/                   # Your captured intents
+│   └── {intent-name}/
+│       ├── requirements.md
+│       ├── system-context.md
+│       └── units/
+├── bolts/                     # Bolt execution records
+├── standards/                 # Project standards
+│   ├── tech-stack.md
+│   ├── coding-standards.md
+│   └── ...
+└── operations/                # Deployment context
+```
+
+</details>
+
+<details>
+<summary><h2>Agent Commands</h2></summary>
+
+### Master Agent
+```bash
+/irismd-master-agent
+```
+| Command | Purpose |
+|---------|---------|
+| `project-init` | Initialize project with standards |
+| `analyze-context` | View current project state |
+| `route-request` | Get directed to the right agent |
+| `explain-flow` | Learn about AI-DLC methodology |
+| `answer-question` | Get help with any irismd question |
+
+### Inception Agent
+```bash
+/irismd-inception-agent
+```
+| Command | Purpose |
+|---------|---------|
+| `intent-create` | Create a new intent |
+| `intent-list` | List all intents |
+| `requirements` | Elaborate intent requirements |
+| `context` | Define system context |
+| `units` | Decompose into units |
+| `story-create` | Create stories for a unit |
+| `bolt-plan` | Plan bolts for stories |
+| `review` | Review inception artifacts |
+
+### Construction Agent
+```bash
+/irismd-construction-agent
+```
+| Command | Purpose |
+|---------|---------|
+| `bolt-start` | Start/continue executing a bolt |
+| `bolt-status` | Check bolt progress |
+| `bolt-list` | List all bolts |
+| `bolt-replan` | Replan bolts if needed |
+
+### Operations Agent
+```bash
+/irismd-operations-agent
+```
+| Command | Purpose |
+|---------|---------|
+| `build` | Build the project |
+| `deploy` | Deploy to environment |
+| `verify` | Verify deployment |
+| `monitor` | Set up monitoring |
+
+</details>
+
+---
+
+## Why irismd?
+
+### AI-Native, Not AI-Retrofitted
+Built from the ground up for AI-driven development. AI-DLC is a reimagination based on first principles, not a retrofit of existing methods.
+
+### Human Oversight as Loss Function
+Validation at each stage catches errors early before they cascade downstream. Each validation transforms artifacts into rich context for subsequent stages.
+
+### Design Techniques Built-In
+DDD, TDD, and BDD are integral to the methodology - not optional add-ons. This addresses the "whitespace" in Agile that has led to quality issues.
+
+### Tool Agnostic
+Works with Claude Code, Cursor, GitHub Copilot, and other AI coding assistants. Markdown-based agents work anywhere.
+
+### Context Engineering
+Specs and Memory Bank provide structured context for AI agents. Agents reload context each session - no more lost knowledge.
+
+---
+
+## Supported Tools
+
+| Tool | Status | Installation |
+|------|--------|--------------|
+| **Claude Code** | Full support | Slash commands in `.claude/commands/` |
+| **Cursor** | Full support | Rules in `.cursor/rules/` (`.mdc` format) |
+| **GitHub Copilot** | Full support | Agents in `.github/agents/` (`.agent.md` format) |
+| **Google Antigravity** | Full support | Agents in `.agent/agents/` |
+
+---
+
+## Troubleshooting
+
+<details>
+<summary><strong>Agent commands not recognized</strong></summary>
+
+Ensure iris.md is installed correctly:
+```bash
+ls .irismd/aidlc/agents/
+```
+
+If the directory is empty or missing, reinstall:
+```bash
+npx irismd@latest install
+```
+</details>
+
+<details>
+<summary><strong>Memory Bank artifacts missing</strong></summary>
+
+Check if the memory-bank directory exists:
+```bash
+ls memory-bank/
+```
+
+If missing, run project initialization:
+```
+/irismd-master-agent
+> project-init
+```
+</details>
+
+<details>
+<summary><strong>Standards not being followed in generated code</strong></summary>
+
+Ensure standards are defined in `memory-bank/standards/`:
+- `tech-stack.md`
+- `coding-standards.md`
+- `architecture.md`
+
+If missing or incomplete, use the Master Agent to define them:
+```
+/irismd-master-agent
+> project-init
+```
+</details>
+
+---
+
+<details>
+<summary><h2>FAQ</h2></summary>
+
+**Q: Agents don't seem to remember previous context?**
+Each agent invocation starts fresh. Agents read context from the Memory Bank at startup. Ensure artifacts are saved after each step.
+
+**Q: How do I reset project state?**
+Clear the `memory-bank/` directory to reset all artifacts. To remove irismd entirely, delete the `.irismd/` directory and tool-specific command files.
+
+**Q: Can I use irismd with existing Agile workflows?**
+AI-DLC is designed as a reimagination, not a retrofit. However, familiar concepts (user stories, acceptance criteria) are retained to ease transition.
+
+**Q: What project types is this suited for?**
+irismd is designed for building complex systems that demand architectural complexity, trade-off management, and scalability. Simpler systems may be better suited for low-code/no-code approaches.
+
+</details>
+
+---
+
+## Resources
+
+- [Documentation](https://iris.md)
+- [AI-DLC Specification (AWS)](https://aws.amazon.com/blogs/devops/ai-driven-development-life-cycle/)
+- [npm Package](https://www.npmjs.com/package/irismd)
+- [GitHub Issues](https://github.com/fabriqaai/irismd/issues)
+
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+<p align="center">
+  Built with AWS' AI-DLC methodology by the <a href="https://iris.md">iris.md</a> team.
+</p>

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/framework.yaml

@@ -0,0 +1,4 @@
+name: iris-core
+version: 0.0.1
+id: iris-core
+description: "The default IRIS framework"

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/interview.yaml

@@ -0,0 +1,9 @@
+schemaVersion: 1
+questions:
+  - id: "success_criteria"
+    field: "successCriteria"
+    required: true
+    text: "What are the success criteria?"
+  - id: "risks"
+    field: "risks"
+    text: "Are there any risks?"

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/pack.yaml

@@ -0,0 +1,2 @@
+include: ["package.json", "tsconfig.json", "README.md", "src/**", "docs/**"]
+exclude: ["node_modules/**", "dist/**", ".iris/runs/**", ".iris/bridge/**"]

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/policy.yaml

@@ -0,0 +1,27 @@
+version: 1
+phases:
+  inception:
+    requires:
+      - path: "memory-bank/intents/"
+        type: "directory"
+    gates: []
+
+  construction:
+    requires:
+      - path: "memory-bank/units/"
+        type: "directory"
+    gates: []
+
+  operations:
+    requires:
+      - path: "memory-bank/logs/"
+        type: "directory"
+    gates: []
+
+transitions:
+  - from: inception
+    to: construction
+  - from: construction
+    to: operations
+  - from: operations
+    to: inception

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/routes.yaml

@@ -0,0 +1,98 @@
+version: 1
+default:
+  route_id: master_default
+  command: iris-master-agent
+  why: Fallback when intent is unclear or spans multiple phases.
+routes:
+- route_id: inception_architecture
+  phase: Inception
+  command: iris-inception-agent
+  match:
+    phrases:
+    - architecture plan
+    - scaffold plan
+    - system design
+    - technical design
+    all_keywords:
+    - plan
+    any_keywords:
+    - architecture
+    - design
+    - scaffold
+    - roadmap
+    - spec
+  exclude:
+    any_keywords:
+    - bug
+    - fix
+    - deploy
+    - release
+    - incident
+  requires:
+    artifacts:
+    - memory-bank/intents/
+    notes: If no intent exists, create one from templates/intent.md first.
+  rationale: Use Inception for framing, constraints, architecture, and an executable
+    plan.
+- route_id: construction_build
+  phase: Construction
+  command: iris-construction-agent
+  match:
+    phrases:
+    - implement
+    - build feature
+    - write code
+    - add endpoint
+    - create component
+    all_keywords:
+    - implement
+    any_keywords:
+    - build
+    - code
+    - feature
+    - api
+    - component
+    - refactor
+  exclude:
+    any_keywords:
+    - deploy
+    - release
+    - incident
+    - monitor
+  requires:
+    artifacts:
+    - memory-bank/units/
+    notes: Construction requires an approved Unit brief; create it if missing.
+  rationale: Use Construction for implementation work that changes source code and
+    produces units/bolts.
+- route_id: operations_runbook
+  phase: Operations
+  command: iris-operations-agent
+  match:
+    phrases:
+    - deploy
+    - release
+    - ci
+    - monitoring
+    - incident
+    - oncall
+    all_keywords:
+    - deploy
+    any_keywords:
+    - release
+    - ci
+    - cd
+    - monitor
+    - alert
+    - incident
+    - rollback
+  exclude:
+    any_keywords:
+    - architecture
+    - scaffold
+    - spec
+  requires:
+    artifacts:
+    - memory-bank/logs/
+    notes: Operations logs are required; record decisions and outcomes.
+  rationale: Use Operations for shipping, reliability, incident response, and runbooks.

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/bolt.md

@@ -0,0 +1,23 @@
+# Bolt: <title>
+
+## Status
+Draft | Ready | Executed | Verified
+
+## Objective
+<one sentence>
+
+## Preconditions
+- Approved unit: `memory-bank/units/<unit>/unit.md`
+
+## Steps
+1.
+2.
+
+## Files to Change
+- <path>
+
+## Verification
+- Commands:
+  - `<command>`
+- Evidence location:
+  - `memory-bank/units/<unit>/review.md` or `memory-bank/logs/...`

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/doctrine-doc-template.md

@@ -0,0 +1,33 @@
+# <Title>
+
+## Purpose
+<One sentence: why this exists.>
+
+## Scope
+- In scope:
+- Out of scope:
+
+## Inputs
+- <required inputs + locations>
+
+## Outputs
+- <guaranteed outputs + locations>
+
+## Hard Rules
+- MUST:
+- MUST NOT:
+- SHOULD (only if necessary):
+
+## Procedure
+1.
+2.
+3.
+
+## Quality Gates
+- Gate 1:
+- Gate 2:
+
+## Failure Modes & Recovery
+- Failure:
+  - Symptom:
+  - Recovery:

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/intent.md

@@ -0,0 +1,23 @@
+# Intent: <title>
+
+## Status
+Draft | Approved | Archived
+
+## Problem
+<What is broken or missing?>
+
+## Goals
+- [ ] <measurable goal>
+
+## Non-goals
+- <explicit exclusions>
+
+## Constraints
+- <time/tech/policy>
+
+## Definition of Done
+- [ ] <observable criteria>
+- Verification: <how to verify>
+
+## Notes
+<links to units/logs>

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/log.md

@@ -0,0 +1,24 @@
+# Log: <topic>
+
+## Date
+YYYY-MM-DD
+
+## Context
+<what triggered this?>
+
+## Decision / Event
+<what happened?>
+
+## Options Considered
+- A:
+- B:
+
+## Outcome
+<chosen action + result>
+
+## Tradeoffs / Risks
+- <tradeoff>
+- <risk>
+
+## Next Actions
+- [ ] <action>

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/review.md

@@ -0,0 +1,21 @@
+# Review: <unit/bolt>
+
+## Gate
+Inception | Construction | Operations
+
+## Checklist
+- [ ] Acceptance criteria met
+- [ ] Tests executed
+- [ ] Evidence recorded
+- [ ] Logs recorded
+- [ ] Rollback documented (if applicable)
+
+## Evidence
+- Unit: `memory-bank/units/<unit>/unit.md`
+- Logs: `memory-bank/logs/...`
+- Test output: <snippet/link>
+
+## Decision
+Accepted | Rejected
+
+## Notes

package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/unit.md

@@ -0,0 +1,31 @@
+# Unit: <title>
+
+## Status
+Draft | Approved | In Progress | Done | Archived
+
+## Scope
+<what is included?>
+
+## Out of Scope
+<what is excluded?>
+
+## Interfaces / Contracts
+- <api/schema/format changes>
+
+## Files Impacted (expected)
+- <path>
+
+## Acceptance Criteria
+- [ ] <criterion>
+
+## Test Plan
+- <commands/tests>
+
+## Risks
+- <risk> → <mitigation>
+
+## Rollback Plan
+<how to revert>
+
+## Links
+- Intent: `memory-bank/intents/<intent>.md`