project-iris 0.0.8 → 0.0.12

package/src/iris_bundle/.iris/aidlc/templates/intent.md

@@ -1,23 +0,0 @@
-# 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/.iris/aidlc/templates/log.md

@@ -1,24 +0,0 @@
-# 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/.iris/aidlc/templates/review.md

@@ -1,21 +0,0 @@
-# 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/.iris/aidlc/templates/unit.md

@@ -1,31 +0,0 @@
-# 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`

package/src/iris_bundle/.iris/aidlc/validation/failure-modes.md

@@ -1,16 +0,0 @@
-# Failure Modes & Recovery
-
-## Missing prerequisites
-- Stop immediately.
-- Create missing artifacts using templates.
-- Log the decision/event.
-- Re-run checklist.
-
-## Phase skipping
-- Return to prior phase.
-- Produce approvals and evidence.
-- Only then proceed.
-
-## Unbounded scope
-- Split into smaller units.
-- Ensure each unit has measurable acceptance criteria.

package/src/iris_bundle/.iris/aidlc/validation/phase-preconditions.md

@@ -1,21 +0,0 @@
-# Phase Preconditions & Exit Criteria
-
-## Inception — Exit to Construction (REQUIRED)
-MUST exist:
-- `memory-bank/intents/<intent>.md` with `Status: Approved`
-- `memory-bank/units/<unit>/unit.md` with `Status: Approved`
-- `memory-bank/logs/<date>__inception-kickoff.md`
-
-## Construction — Entry (REQUIRED)
-MUST exist:
-- Approved unit: `memory-bank/units/<unit>/unit.md`
-- Ready bolt: `memory-bank/bolts/<unit>/<bolt>/bolt.md` with `Status: Ready`
-
-## Construction — Exit to Operations (REQUIRED)
-MUST exist:
-- Evidence in `memory-bank/units/<unit>/review.md` (Accepted) OR a log with equivalent evidence
-- `memory-bank/logs/<date>__construction-complete.md`
-
-## Operations — Entry (REQUIRED)
-MUST exist:
-- `memory-bank/logs/<date>__ops-handover.md`

package/src/iris_bundle/.iris/aidlc/validation/quality-checklist.md

@@ -1,20 +0,0 @@
-# Quality Checklist
-
-## Universal
-- [ ] Required artifacts exist at canonical paths
-- [ ] Decisions logged for any architecture/behavior change
-- [ ] No secrets in context or repo
-
-## Inception
-- [ ] Goals are measurable
-- [ ] Acceptance criteria are testable
-- [ ] Risks + rollback documented
-
-## Construction
-- [ ] Work references an approved unit
-- [ ] Tests executed
-- [ ] Evidence recorded
-
-## Operations
-- [ ] Handover recorded
-- [ ] Incident logging process ready

package/src/iris_bundle/.iris/policy.yaml

@@ -1,27 +0,0 @@
-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/.iris/routes.yaml

@@ -1,98 +0,0 @@
-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/.iris/state.yaml

@@ -1,7 +0,0 @@
-current_phase: Inception
-active:
-  intent: null
-  unit: null
-  bolt: null
-last_validation: null
-notes: Initialize by creating an intent using .iris/aidlc/templates/intent.md

package/src/iris_bundle/.iris/tools/claude/.claude/claude.md

@@ -1,9 +0,0 @@
-# IRIS for Claude
-
-Use the command palette entries in `.claude/commands/`:
-- iris-master-agent
-- iris-inception-agent
-- iris-construction-agent
-- iris-operations-agent
-
-Doctrine lives in `.iris/aidlc/`.

package/src/iris_bundle/.iris/tools/claude/.claude/commands/compare-specs.md

@@ -1,203 +0,0 @@
-# Compare Specs and Implementation
-
-**Command**: `/compare-specs`
-
-Compare specifications in `memory-bank/` with their corresponding implementations in `src/` to identify gaps, inconsistencies, and missing items.
-
----
-
-## Comparison Modes
-
-Choose a comparison mode based on what you want to analyze:
-
-### Mode 1: Spec → Implementation (Default)
-Find what's documented in specs but missing or inconsistent in implementation.
-- Identifies incomplete implementations
-- Finds mismatches between spec requirements and actual code
-
-### Mode 2: Implementation → Spec
-Find what's implemented but not documented in specs.
-- Identifies undocumented features
-- Finds implementation details that should be in specs
-
----
-
-## Process
-
-### Step 1: Identify Scope
-
-Ask the user:
-
-> **What would you like to compare?**
->
-> 1. **Specific agent** (e.g., inception-agent, construction-agent, master-agent)
-> 2. **Specific feature** (e.g., bolt planning, story creation, estimation)
-> 3. **Full system** (compare all specs vs all implementations)
->
-> **Direction:**
-> - A) Spec → Implementation (find missing implementations)
-> - B) Implementation → Spec (find missing documentation)
-> - C) Both directions
-
-### Step 2: Locate Files
-
-**Spec locations** (`memory-bank/`):
-```
-memory-bank/
-├── intents/
-│   ├── 001-multi-agent-orchestration/
-│   │   └── units/
-│   │       ├── master-agent/unit-brief.md
-│   │       ├── inception-agent/unit-brief.md
-│   │       ├── construction-agent/unit-brief.md
-│   │       └── operations-agent/unit-brief.md
-│   ├── 002-agentic-coding-tool-integration/
-│   └── 003-memory-bank-system/
-├── standards/
-│   ├── coding-standards.md
-│   ├── tech-stack.md
-│   └── system-architecture.md
-├── research/
-│   └── (research documentation)
-├── glossary.md
-└── term-mappings.md
-```
-
-**Implementation locations** (`src/flows/aidlc/`):
-```
-src/flows/aidlc/
-├── agents/
-│   ├── master-agent.md
-│   ├── inception-agent.md
-│   ├── construction-agent.md
-│   └── operations-agent.md
-├── commands/
-├── .iris/
-│   ├── skills/
-│   │   ├── master/
-│   │   ├── inception/
-│   │   └── construction/
-│   ├── templates/
-│   └── memory-bank.yaml
-```
-
-### Step 3: Compare Content
-
-For each file pair, analyze:
-
-| Aspect | Check |
-|--------|-------|
-| **Terminology** | Same terms used consistently? |
-| **Features** | All spec features implemented? |
-| **Naming conventions** | Match between spec and implementation? |
-| **Estimation guidance** | Consistent across both? |
-| **Dependencies** | All documented dependencies implemented? |
-| **Commands** | All spec commands exist in implementation? |
-| **Skills** | All spec skills have implementations? |
-
-### Step 4: Report Findings
-
-Generate a gap analysis report:
-
-```markdown
-## Gap Analysis Report
-
-### Comparison: {scope}
-- Direction: {Spec → Impl | Impl → Spec | Both}
-- Files analyzed: {count}
-
----
-
-### Gaps Found
-
-#### Missing in Implementation (Spec → Impl)
-| Spec | Item | Status |
-|------|------|--------|
-| inception-agent/unit-brief.md | Global story index | Not implemented |
-| ... | ... | ... |
-
-#### Missing in Specs (Impl → Spec)
-| Implementation | Item | Status |
-|----------------|------|--------|
-| inception-agent.md | Naming conventions section | Not documented |
-| ... | ... | ... |
-
-#### Inconsistencies
-| Location | Spec Says | Implementation Says |
-|----------|-----------|---------------------|
-| Bolt estimation | Hours only | Uses "1-2 days" |
-| ... | ... | ... |
-
----
-
-### Recommended Actions
-
-1. **High Priority** (blocking or incorrect):
-   - { action }
-
-2. **Medium Priority** (missing features):
-   - { action }
-
-3. **Low Priority** (documentation polish):
-   - { action }
-
----
-
-### Update Plan
-
-Based on chosen direction:
-
-**If updating specs:**
-1. { step }
-2. { step }
-
-**If updating implementation:**
-1. { step }
-2. { step }
-```
-
----
-
-## Example Usage
-
-**User**: `/compare-specs`
-
-**Assistant**:
-> What would you like to compare?
-> 1. Specific agent
-> 2. Specific feature
-> 3. Full system
->
-> And in which direction?
-> A) Spec → Implementation
-> B) Implementation → Spec
-> C) Both
-
-**User**: `1 - inception-agent, C - both`
-
-**Assistant**: *Reads spec and implementation files, generates gap analysis*
-
----
-
-## Quick Comparisons
-
-For common comparisons, use these shortcuts:
-
-| Shortcut | Scope |
-|----------|-------|
-| `/compare-specs agents` | All agent specs vs implementations |
-| `/compare-specs skills` | All skill specs vs implementations |
-| `/compare-specs memory-bank` | Memory bank spec vs implementation |
-| `/compare-specs naming` | Naming conventions consistency |
-| `/compare-specs estimation` | Estimation guidance consistency |
-
----
-
-## Output
-
-After analysis, provide:
-
-1. **Summary**: X gaps found (Y in implementation, Z in specs)
-2. **Gap table**: Detailed list of discrepancies
-3. **Recommended plan**: Steps to resolve gaps
-4. **User choice**: Ask if they want to fix specs, implementation, or both

package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-construction-agent.md

@@ -1,25 +0,0 @@
-# Iris Construction Agent
-
-## What this does
-Runs the IRIS **Construction** agent using the canonical IRIS doctrine in `.iris/aidlc/`.
-
-## REQUIRED context (load in this order)
-1. `.iris/aidlc/context/load-order.md`
-2. `.iris/aidlc/standards/phases-and-gates.md`
-3. `.iris/aidlc/standards/artifacts-registry.md`
-4. `.iris/aidlc/validation/phase-preconditions.md`
-5. `.iris/aidlc/commands/iris-construction-agent.md`
-6. Repo project signals (if present): `specs.md`, `README.md`, `package.json`, `tsconfig.json`, relevant `src/**`
-7. Phase memory-bank artifacts:
-   - Inception: `memory-bank/intents/**`
-   - Construction: `memory-bank/units/**`, `memory-bank/bolts/**`
-   - Operations: `memory-bank/logs/**`, `memory-bank/standards/**`
-
-## Hard rules
-- MUST create/update artifacts in `memory-bank/` using templates in `.iris/aidlc/templates/`.
-- MUST stop if required artifacts for the phase are missing and ask to create them.
-- MUST keep outputs deterministic: numbered steps, explicit file paths, and acceptance criteria.
-- MUST NOT delete files unless the user explicitly requests it.
-
-## Start
-Execute `.iris/aidlc/commands/iris-construction-agent.md`.

package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-inception-agent.md

@@ -1,25 +0,0 @@
-# Iris Inception Agent
-
-## What this does
-Runs the IRIS **Inception** agent using the canonical IRIS doctrine in `.iris/aidlc/`.
-
-## REQUIRED context (load in this order)
-1. `.iris/aidlc/context/load-order.md`
-2. `.iris/aidlc/standards/phases-and-gates.md`
-3. `.iris/aidlc/standards/artifacts-registry.md`
-4. `.iris/aidlc/validation/phase-preconditions.md`
-5. `.iris/aidlc/commands/iris-inception-agent.md`
-6. Repo project signals (if present): `specs.md`, `README.md`, `package.json`, `tsconfig.json`, relevant `src/**`
-7. Phase memory-bank artifacts:
-   - Inception: `memory-bank/intents/**`
-   - Construction: `memory-bank/units/**`, `memory-bank/bolts/**`
-   - Operations: `memory-bank/logs/**`, `memory-bank/standards/**`
-
-## Hard rules
-- MUST create/update artifacts in `memory-bank/` using templates in `.iris/aidlc/templates/`.
-- MUST stop if required artifacts for the phase are missing and ask to create them.
-- MUST keep outputs deterministic: numbered steps, explicit file paths, and acceptance criteria.
-- MUST NOT delete files unless the user explicitly requests it.
-
-## Start
-Execute `.iris/aidlc/commands/iris-inception-agent.md`.

package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-master-agent.md

@@ -1,25 +0,0 @@
-# Iris Master Agent
-
-## What this does
-Runs the IRIS **Master** agent using the canonical IRIS doctrine in `.iris/aidlc/`.
-
-## REQUIRED context (load in this order)
-1. `.iris/aidlc/context/load-order.md`
-2. `.iris/aidlc/standards/phases-and-gates.md`
-3. `.iris/aidlc/standards/artifacts-registry.md`
-4. `.iris/aidlc/validation/phase-preconditions.md`
-5. `.iris/aidlc/commands/iris-master-agent.md`
-6. Repo project signals (if present): `specs.md`, `README.md`, `package.json`, `tsconfig.json`, relevant `src/**`
-7. Phase memory-bank artifacts:
-   - Inception: `memory-bank/intents/**`
-   - Construction: `memory-bank/units/**`, `memory-bank/bolts/**`
-   - Operations: `memory-bank/logs/**`, `memory-bank/standards/**`
-
-## Hard rules
-- MUST create/update artifacts in `memory-bank/` using templates in `.iris/aidlc/templates/`.
-- MUST stop if required artifacts for the phase are missing and ask to create them.
-- MUST keep outputs deterministic: numbered steps, explicit file paths, and acceptance criteria.
-- MUST NOT delete files unless the user explicitly requests it.
-
-## Start
-Execute `.iris/aidlc/commands/iris-master-agent.md`.

package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-operations-agent.md

@@ -1,25 +0,0 @@
-# Iris Operations Agent
-
-## What this does
-Runs the IRIS **Operations** agent using the canonical IRIS doctrine in `.iris/aidlc/`.
-
-## REQUIRED context (load in this order)
-1. `.iris/aidlc/context/load-order.md`
-2. `.iris/aidlc/standards/phases-and-gates.md`
-3. `.iris/aidlc/standards/artifacts-registry.md`
-4. `.iris/aidlc/validation/phase-preconditions.md`
-5. `.iris/aidlc/commands/iris-operations-agent.md`
-6. Repo project signals (if present): `specs.md`, `README.md`, `package.json`, `tsconfig.json`, relevant `src/**`
-7. Phase memory-bank artifacts:
-   - Inception: `memory-bank/intents/**`
-   - Construction: `memory-bank/units/**`, `memory-bank/bolts/**`
-   - Operations: `memory-bank/logs/**`, `memory-bank/standards/**`
-
-## Hard rules
-- MUST create/update artifacts in `memory-bank/` using templates in `.iris/aidlc/templates/`.
-- MUST stop if required artifacts for the phase are missing and ask to create them.
-- MUST keep outputs deterministic: numbered steps, explicit file paths, and acceptance criteria.
-- MUST NOT delete files unless the user explicitly requests it.
-
-## Start
-Execute `.iris/aidlc/commands/iris-operations-agent.md`.

package/src/iris_bundle/.iris/tools/codex/AGENTS.md

@@ -1,15 +0,0 @@
-# IRIS Agents (Codex)
-
-This repository uses IRIS doctrine in `.iris/aidlc/`.
-
-## How to run
-Use one of these entrypoints (read and follow):
-- `.iris/aidlc/commands/iris-master-agent.md`
-- `.iris/aidlc/commands/iris-inception-agent.md`
-- `.iris/aidlc/commands/iris-construction-agent.md`
-- `.iris/aidlc/commands/iris-operations-agent.md`
-
-## Mandatory rules
-- Write SDLC artifacts into `memory-bank/` using `.iris/aidlc/templates/`.
-- Do not skip phases; follow `.iris/aidlc/standards/phases-and-gates.md`.
-- Stop and request missing required artifacts rather than guessing.

package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-construction-agent.md

@@ -1,25 +0,0 @@
-# Iris Construction Agent
-
-## What this does
-Runs the IRIS **Construction** agent using the canonical IRIS doctrine in `.iris/aidlc/`.
-
-## REQUIRED context (load in this order)
-1. `.iris/aidlc/context/load-order.md`
-2. `.iris/aidlc/standards/phases-and-gates.md`
-3. `.iris/aidlc/standards/artifacts-registry.md`
-4. `.iris/aidlc/validation/phase-preconditions.md`
-5. `.iris/aidlc/commands/iris-construction-agent.md`
-6. Repo project signals (if present): `specs.md`, `README.md`, `package.json`, `tsconfig.json`, relevant `src/**`
-7. Phase memory-bank artifacts:
-   - Inception: `memory-bank/intents/**`
-   - Construction: `memory-bank/units/**`, `memory-bank/bolts/**`
-   - Operations: `memory-bank/logs/**`, `memory-bank/standards/**`
-
-## Hard rules
-- MUST create/update artifacts in `memory-bank/` using templates in `.iris/aidlc/templates/`.
-- MUST stop if required artifacts for the phase are missing and ask to create them.
-- MUST keep outputs deterministic: numbered steps, explicit file paths, and acceptance criteria.
-- MUST NOT delete files unless the user explicitly requests it.
-
-## Start
-Execute `.iris/aidlc/commands/iris-construction-agent.md`.

package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-inception-agent.md

@@ -1,25 +0,0 @@
-# Iris Inception Agent
-
-## What this does
-Runs the IRIS **Inception** agent using the canonical IRIS doctrine in `.iris/aidlc/`.
-
-## REQUIRED context (load in this order)
-1. `.iris/aidlc/context/load-order.md`
-2. `.iris/aidlc/standards/phases-and-gates.md`
-3. `.iris/aidlc/standards/artifacts-registry.md`
-4. `.iris/aidlc/validation/phase-preconditions.md`
-5. `.iris/aidlc/commands/iris-inception-agent.md`
-6. Repo project signals (if present): `specs.md`, `README.md`, `package.json`, `tsconfig.json`, relevant `src/**`
-7. Phase memory-bank artifacts:
-   - Inception: `memory-bank/intents/**`
-   - Construction: `memory-bank/units/**`, `memory-bank/bolts/**`
-   - Operations: `memory-bank/logs/**`, `memory-bank/standards/**`
-
-## Hard rules
-- MUST create/update artifacts in `memory-bank/` using templates in `.iris/aidlc/templates/`.
-- MUST stop if required artifacts for the phase are missing and ask to create them.
-- MUST keep outputs deterministic: numbered steps, explicit file paths, and acceptance criteria.
-- MUST NOT delete files unless the user explicitly requests it.
-
-## Start
-Execute `.iris/aidlc/commands/iris-inception-agent.md`.