project-iris 0.0.7 → 0.0.11

package/src/iris_bundle/.iris/aidlc/skills/governance/stop-conditions.md

@@ -1,11 +0,0 @@
-# Skill: Stop Conditions
-
-## Hard Rules
-An agent MUST stop if:
-- required artifacts are missing
-- acceptance criteria are not testable
-- approvals are missing
-- a policy violation is detected
-
-## Recovery
-Create missing artifacts using templates, then continue.

package/src/iris_bundle/.iris/aidlc/skills/reasoning/decomposition.md

@@ -1,23 +0,0 @@
-# Skill: Decomposition
-
-## Purpose
-Turn intent into units/bolts that can be executed and verified.
-
-## Inputs
-- Approved intent
-- Constraints and existing context
-
-## Outputs
-- Units (`memory-bank/units/<unit>/unit.md`)
-- Bolts (`memory-bank/bolts/<unit>/<bolt>/bolt.md`) as needed
-
-## Hard Rules
-- MUST produce measurable acceptance criteria.
-- MUST keep units verifiable in one cycle.
-- MUST log decomposition decisions.
-
-## Procedure
-1. Extract goals/constraints from intent.
-2. Define units as independently testable deliverables.
-3. Create bolts for implementation slices if helpful.
-4. Record decisions in logs.

package/src/iris_bundle/.iris/aidlc/skills/reasoning/risk-analysis.md

@@ -1,14 +0,0 @@
-# Skill: Risk Analysis
-
-## Purpose
-Identify risks and define mitigations/rollback.
-
-## Hard Rules
-- MUST add rollback for risky changes.
-- MUST log architecture risks.
-
-## Procedure
-1. Identify failure modes.
-2. Add mitigations.
-3. Add rollback.
-4. Log major risks.

package/src/iris_bundle/.iris/aidlc/skills/reasoning/verification.md

@@ -1,21 +0,0 @@
-# Skill: Verification
-
-## Purpose
-Prove changes with evidence.
-
-## Inputs
-- Unit acceptance criteria + test plan
-- Code changes
-
-## Outputs
-- Evidence recorded in review/log artifacts
-
-## Hard Rules
-- MUST run specified tests or explicitly update the unit to define them.
-- MUST record evidence.
-- MUST NOT claim “verified” without evidence.
-
-## Procedure
-1. Run tests.
-2. Capture outputs.
-3. Record in review.md or log.

package/src/iris_bundle/.iris/aidlc/standards/artifacts-registry.md

@@ -1,38 +0,0 @@
-# Artifacts Registry (Canonical)
-
-## Purpose
-Define IRIS artifacts and their authoritative locations.
-
-## Artifacts
-### Intent
-- Path: `memory-bank/intents/<intent-slug>.md`
-- Template: `.iris/aidlc/templates/intent.md`
-- Owner: Inception Agent
-- Lifecycle: Draft → Approved → Archived
-
-### Unit
-- Path: `memory-bank/units/<unit-slug>/unit.md`
-- Template: `.iris/aidlc/templates/unit.md`
-- Owner: Inception (create/approve), Construction (execute)
-- Lifecycle: Draft → Approved → In Progress → Done
-
-### Bolt
-- Path: `memory-bank/bolts/<unit-slug>/<bolt-slug>/bolt.md`
-- Template: `.iris/aidlc/templates/bolt.md`
-- Owner: Construction
-- Lifecycle: Draft → Ready → Executed → Verified
-
-### Log
-- Path: `memory-bank/logs/YYYY-MM-DD__<topic>.md`
-- Template: `.iris/aidlc/templates/log.md`
-- Owner: All agents
-- Lifecycle: Immutable (append via new logs)
-
-### Review
-- Path: `memory-bank/units/<unit-slug>/review.md` (recommended) or `memory-bank/logs/`
-- Template: `.iris/aidlc/templates/review.md`
-- Owner: Master (or delegated reviewer)
-
-## Hard Rules
-- If a phase gate requires an artifact, it MUST exist at the exact path.
-- Artifacts MUST NOT be embedded inside unrelated documents.

package/src/iris_bundle/.iris/aidlc/standards/decision-logging.md

@@ -1,16 +0,0 @@
-# Decision Logging Standard
-
-## Purpose
-Prevent silent drift and preserve rationale.
-
-## Hard Rules
-- Any decision with downstream impact MUST be logged in `memory-bank/logs/` using `templates/log.md`.
-- Logs MUST include:
-  - context
-  - options considered
-  - chosen option + rationale
-  - tradeoffs/risks
-  - next actions
-
-## Quality Gate
-If a reviewer cannot explain “why”, the change is incomplete.

package/src/iris_bundle/.iris/aidlc/standards/doctrine-structure.md

@@ -1,31 +0,0 @@
-# Doctrine Structure Standard
-
-## Purpose
-Freeze the IRIS doctrine layout so it remains stable, searchable, and enforceable.
-
-## Scope
-- In scope: `.iris/aidlc/**` structure, naming, canonical locations.
-- Out of scope: tool-specific wrappers (kept outside doctrine or mirrored under `.iris/tools/` at repo root).
-
-## Hard Rules
-- Top-level directories under `.iris/aidlc/` MUST remain:
-  - `agents/`, `commands/`, `skills/`, `standards/`, `templates/`, `context/`, `memory/`, `validation/`
-- New top-level directories MUST NOT be added unless all are updated:
-  - this document
-  - `standards/file-structure.md`
-  - `context/context-map.md`
-- Rules MUST NOT be duplicated across documents:
-  - reference `standards/*` instead of re-copying.
-
-## Canonical locations
-- Agent definitions: `agents/`
-- Tool entrypoints: `commands/`
-- Procedures/playbooks: `skills/`
-- Governance: `standards/`
-- Templates: `templates/`
-- Context rules: `context/`
-- Memory rules: `memory/`
-- Validation rules: `validation/`
-
-## Quality Gate
-Any change to structure MUST include an updated tree and rationale in a decision log.

package/src/iris_bundle/.iris/aidlc/standards/documentation-rules.md

@@ -1,15 +0,0 @@
-# Documentation Rules
-
-## Purpose
-Make outputs actionable, reviewable, and enforceable.
-
-## Hard Rules
-- Any plan MUST specify:
-  - exact file paths it will create/modify
-  - acceptance criteria and verification method
-  - stop conditions (when to halt for missing inputs)
-- “Done” MUST be measurable.
-- A unit/bolt MUST be small enough to implement and verify in one cycle.
-
-## MUST NOT
-- Avoid vague verbs (“handle”, “improve”, “optimize”) without measurable criteria.

package/src/iris_bundle/.iris/aidlc/standards/file-structure.md

@@ -1,21 +0,0 @@
-# File Structure Standard
-
-## Purpose
-Define canonical repo locations used by IRIS.
-
-## Hard Rules
-- IRIS doctrine MUST live at: `.iris/aidlc/`
-- Project memory MUST live at: `memory-bank/`
-- Canonical memory-bank folders MUST exist:
-  - `memory-bank/intents/`
-  - `memory-bank/units/`
-  - `memory-bank/bolts/`
-  - `memory-bank/standards/`
-  - `memory-bank/logs/`
-
-## MUST NOT
-- Do not store project decisions only in chat history.
-- Do not introduce alternate memory roots unless doctrine is updated.
-
-## Quality Gate
-A repo is not “IRIS-ready” until the memory-bank exists.

package/src/iris_bundle/.iris/aidlc/standards/naming-conventions.md

@@ -1,18 +0,0 @@
-# Naming Conventions
-
-## Purpose
-Ensure artifacts are predictable and routable.
-
-## Hard Rules
-- Filenames and folders MUST be `kebab-case`.
-- Agent docs MUST be prefixed with `iris-` and end with `-agent.md`.
-- Commands MUST be prefixed with `iris-` and match the agent name.
-- Logs MUST be prefixed with `YYYY-MM-DD__`.
-
-## Recommended patterns
-- Unit folder: `memory-bank/units/<unit-slug>/`
-- Bolt folder: `memory-bank/bolts/<unit-slug>/<bolt-slug>/`
-
-## Failure Modes & Recovery
-- Failure: inconsistent naming prevents routing/validation.
-  - Recovery: rename to kebab-case and update references.

package/src/iris_bundle/.iris/aidlc/standards/phases-and-gates.md

@@ -1,25 +0,0 @@
-# Phases & Gates
-
-## Purpose
-Define SDLC phases and forbid phase skipping.
-
-## Phases
-1. **Inception**
-   - Output: approved intent + approved units + kickoff log
-2. **Construction**
-   - Output: implementation + verification evidence + completion log
-3. **Operations**
-   - Output: handover log + incident/runbook logs as needed
-
-## Allowed transitions
-- Inception → Construction
-- Construction → Operations
-- Operations → Inception (new intent only)
-
-## Hard Rules
-- Construction MUST NOT begin without an approved unit.
-- Operations MUST NOT begin without accepted verification evidence.
-
-## Gate authority
-- Master Agent is gatekeeper by default.
-- Delegation is allowed but MUST be logged.

package/src/iris_bundle/.iris/aidlc/standards/routes-and-routing.md

@@ -1,35 +0,0 @@
-# IRIS Routing Doctrine
-
-## Purpose
-Define how IRIS maps user intent to the correct agent command **without ambiguity** and **without hidden heuristics**.
-
-## Scope
-This standard governs:
-- `.iris/routes.yaml` format and semantics
-- Required routing metadata (rationale, exclusions, required context)
-- How tools and Navi MUST apply routing
-
-## Hard Rules
-- Routing MUST be deterministic: same input → same route selection given same routes file.
-- Routing MUST be explainable: every match MUST include a rationale.
-- Routing MUST include exclusions to prevent false positives.
-- If no route matches with high confidence, IRIS MUST fall back to **iris-master-agent** and request clarification.
-
-## Route precedence
-1. Exact phrase matches
-2. Strong keyword matches (all required keywords present)
-3. Weak keyword matches (some keywords present) — only if no strong match exists
-4. Default route: `iris-master-agent`
-
-## Output of routing
-A router MUST output:
-- `route_id`
-- selected `command`
-- `why` (the route rationale)
-- `missing_context` (if required context is absent)
-- suggested next action (which artifact to create first)
-
-## Anti-patterns
-- DO NOT route directly to Construction when Inception artifacts are missing.
-- DO NOT route to Operations for requests that change scope/architecture.
-- DO NOT invent routes at runtime; update `.iris/routes.yaml` instead.

package/src/iris_bundle/.iris/aidlc/standards/tool-wrappers.md

@@ -1,32 +0,0 @@
-# Tool Wrapper Doctrine
-
-## Purpose
-Ensure tool-specific command wrappers (Claude/Cursor/Gemini/Antigravity/Codex) invoke IRIS consistently.
-
-## Hard Rules
-- Tool wrappers MUST be thin: they MUST NOT redefine doctrine. They MUST reference `.iris/aidlc/**`.
-- Tool wrappers MUST instruct the tool to load:
-  1) the requested IRIS command entrypoint
-  2) the minimum required memory-bank artifacts for that phase
-  3) any repo-local constraints (e.g., `specs.md`, `README.md`, `package.json` if present)
-- Tool wrappers MUST forbid destructive operations unless explicitly requested.
-- Tool wrappers MUST require the agent to produce artifacts into `memory-bank/` using IRIS templates.
-
-## Minimum context set
-All wrappers MUST load:
-- `.iris/aidlc/context/load-order.md`
-- `.iris/aidlc/standards/phases-and-gates.md`
-- `.iris/aidlc/standards/artifacts-registry.md`
-- `.iris/aidlc/validation/phase-preconditions.md`
-
-Plus phase-specific memory-bank files:
-- Inception: `memory-bank/intents/*`
-- Construction: `memory-bank/units/*`, `memory-bank/bolts/*`
-- Operations: `memory-bank/logs/*`, `memory-bank/standards/*`
-
-## Wrapper content requirements
-Each wrapper MUST include:
-- What the command does
-- What inputs it needs
-- What files it MUST write/update
-- Stop conditions

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

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

@@ -1,33 +0,0 @@
-# <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/.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/`.