project-iris 0.0.1

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units/operations-agent/unit-brief.md

@@ -0,0 +1,72 @@
+# Unit Brief: Operations Agent
+
+## Overview
+
+The Operations Agent is the DevOps engineer that manages deployment, verification, and monitoring of completed construction work.
+
+---
+
+## Scope
+
+### In Scope
+
+- Build deployment artifacts (build skill)
+- Deploy to environments (deploy skill)
+- Verify deployment success (verify skill)
+- Setup monitoring and observability (monitor skill)
+
+### Out of Scope
+
+- Requirements gathering (Inception Agent)
+- Code implementation (Construction Agent)
+- Project routing (Master Agent)
+
+---
+
+## Technical Context
+
+### Entry Points
+
+- `/irismd-operations-agent` - Activate Operations Agent
+
+### Dependencies
+
+- Memory Bank schema (`memory-bank.yaml`)
+- Completed bolt artifacts
+- Project standards (`memory-bank/standards/`)
+- Operations templates (`templates/operations/`)
+
+### Outputs
+
+- Deployment artifacts
+- Deployment verification reports
+- Monitoring configuration
+- Operations context (`memory-bank/operations/`)
+
+---
+
+## Implementation Notes
+
+### Persona Characteristics
+
+- Role: DevOps Engineer
+- Communication Style: Systematic and verification-focused
+- Principle: Verify construction completion before deploying
+
+### Critical Actions
+
+1. VERIFY construction is complete before deployment
+2. FOLLOW deployment progression: dev → staging → prod
+3. VERIFY each deployment before proceeding to next environment
+4. SETUP monitoring before marking deployment complete
+
+### Output Formatting Requirements
+
+All agent outputs MUST follow the output formatting standards:
+
+- 🚫 **NEVER** use ASCII tables for options
+- ✅ **ALWAYS** use numbered list format: `N - **Option**: Description`
+- ✅ **ALWAYS** use status indicators: ✅ (done) ⏳ (current) [ ] (pending) 🚫 (blocked)
+- ✅ **ALWAYS** end with suggested next step pattern
+
+See `memory-bank/standards/output-formatting.md` for complete specification.

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units.md

@@ -0,0 +1,168 @@
+# Units: Multi-Agent Orchestration
+
+## Unit Decomposition
+
+This intent is decomposed into four units, each representing a specialized agent.
+
+---
+
+## Unit 1: Master Agent
+
+### Description
+
+Central orchestrator that analyzes project state, routes to specialist agents, and facilitates project initialization.
+
+### Responsibilities
+
+- Analyze project state from Memory Bank
+- Determine current AI-DLC phase
+- Route users to appropriate specialist agent
+- Provide project health dashboard
+- Facilitate project initialization (standards setup)
+
+### Skills
+
+| Skill | File | Description |
+|-------|------|-------------|
+| `analyze-context` | `skills/master/analyze-context.md` | Deduce project state from artifacts |
+| `route-request` | `skills/master/route-request.md` | Route to specialist agent |
+| `explain-flow` | `skills/master/explain-flow.md` | Explain AI-DLC methodology |
+| `answer-question` | `skills/master/answer-question.md` | Answer project/process questions |
+| `project-init` | `skills/master/project-init.md` | Initialize project standards |
+
+### Dependencies
+
+- Memory Bank (read schema, read artifacts)
+- Standards System (for project-init)
+
+---
+
+## Unit 2: Inception Agent
+
+### Description
+
+Requirements architect that transforms high-level intents into actionable plans.
+
+### Responsibilities
+
+- Create and manage intents
+- Gather functional and non-functional requirements
+- Define system context and boundaries
+- Decompose intents into units
+- Create user stories with acceptance criteria
+- Plan bolts for execution
+- Validate with human at each step
+
+### Skills
+
+| Skill | File | Description |
+|-------|------|-------------|
+| `intent-create` | `skills/inception/intent-create.md` | Create new intent |
+| `intent-list` | `skills/inception/intent-list.md` | List all intents |
+| `requirements` | `skills/inception/requirements.md` | Gather FR/NFR |
+| `context` | `skills/inception/context.md` | Define system boundaries |
+| `units` | `skills/inception/units.md` | Decompose into units |
+| `story-create` | `skills/inception/story-create.md` | Create user stories |
+| `bolt-plan` | `skills/inception/bolt-plan.md` | Plan bolt instances |
+| `review` | `skills/inception/review.md` | Complete inception phase |
+| `navigator` | `skills/inception/navigator.md` | Show interactive menu |
+
+### Dependencies
+
+- Memory Bank (read/write intents, units, stories)
+- Templates (inception templates)
+
+---
+
+## Unit 3: Construction Agent
+
+### Description
+
+Software engineer that executes bolts through their defined stages.
+
+### Responsibilities
+
+- Execute bolts through defined stages
+- Load and follow bolt type definitions
+- Execute DDD stages (model, design, code, test)
+- Validate stage completion before advancing
+- Load project standards
+- Generate implementation artifacts
+
+### Skills
+
+| Skill | File | Description |
+|-------|------|-------------|
+| `bolt-plan` | `skills/construction/bolt-plan.md` | Plan bolts for unit |
+| `bolt-start` | `skills/construction/bolt-start.md` | Start/continue bolt |
+| `bolt-status` | `skills/construction/bolt-status.md` | Check bolt status |
+| `bolt-list` | `skills/construction/bolt-list.md` | List bolts for unit |
+| `navigator` | `skills/construction/navigator.md` | Show construction menu |
+
+### Dependencies
+
+- Memory Bank (read/write bolts, units)
+- Bolt Types (read stage definitions)
+- Standards (load tech-stack, coding-standards)
+- Templates (construction templates)
+
+---
+
+## Unit 4: Operations Agent
+
+### Description
+
+DevOps engineer that manages deployment and monitoring.
+
+### Responsibilities
+
+- Verify construction completion
+- Build deployment artifacts
+- Deploy to environments
+- Verify deployment success
+- Setup monitoring and observability
+
+### Skills
+
+| Skill | File | Description |
+|-------|------|-------------|
+| `build` | `skills/operations/build.md` | Build deployment artifacts |
+| `deploy` | `skills/operations/deploy.md` | Deploy to environment |
+| `verify` | `skills/operations/verify.md` | Verify deployment success |
+| `monitor` | `skills/operations/monitor.md` | Setup monitoring |
+
+### Dependencies
+
+- Memory Bank (read/write operations context)
+- Standards (deployment configuration)
+
+---
+
+## Unit Dependency Graph
+
+```text
+┌─────────────────┐
+│  Master Agent   │
+│  (Orchestrator) │
+└────────┬────────┘
+         │ routes to
+         ▼
+┌─────────────────┐
+│ Inception Agent │
+│   (Planning)    │
+└────────┬────────┘
+         │ produces artifacts for
+         ▼
+┌─────────────────┐
+│Construction     │
+│   Agent         │
+│  (Building)     │
+└────────┬────────┘
+         │ produces artifacts for
+         ▼
+┌─────────────────┐
+│ Operations Agent│
+│  (Deploying)    │
+└─────────────────┘
+```
+

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/requirements.md

@@ -0,0 +1,96 @@
+---
+status: complete
+completed: 2025-12-25
+note: "Implemented before irismd dogfooding. Stories not tracked in AI-DLC."
+---
+
+# Intent: Agentic Coding Tool Integration
+
+## Overview
+
+Provide seamless integration with multiple agentic coding tools (Claude Code, Cursor, GitHub Copilot) through a unified installation mechanism and consistent slash command interface.
+
+---
+
+## Functional Requirements
+
+### FR-1: Multi-Tool Support
+
+- FR-1.1: System SHALL support Claude Code integration (commands + agents)
+- FR-1.2: System SHALL support Cursor integration (rules with MDC format)
+- FR-1.3: System SHALL support GitHub Copilot integration (workspace agents)
+- FR-1.4: System SHALL support Google Antigravity integration
+- FR-1.5: System SHALL support additional tools: Windsurf, Cline, Roo Code, Kiro CLI, Gemini CLI, Codex, Kilo Code, OpenCode
+- FR-1.6: System SHALL detect which agentic coding tools are available on the user's system
+- FR-1.7: System SHALL allow user to select which tools to install to
+
+### FR-2: Interactive Installation
+
+- FR-2.1: System SHALL provide an interactive CLI installer via `npx irismd install`
+- FR-2.2: Installer SHALL display tool detection results
+- FR-2.3: Installer SHALL allow flow selection (AI-DLC, future: Agile)
+- FR-2.4: Installer SHALL copy appropriate files to each selected tool
+
+### FR-3: File Installation
+
+- FR-3.1: For Claude Code: Install slash commands to `.claude/commands/`
+- FR-3.2: For Claude Code: Install agents to `.claude/agents/`
+- FR-3.3: For Cursor: Install rules to `.cursor/rules/` (`.mdc` format with frontmatter)
+- FR-3.4: For GitHub Copilot: Install agents to `.github/agents/` (`.agent.md` format)
+- FR-3.5: For Google Antigravity: Install agents to `.agent/agents/`
+- FR-3.6: For all tools: Install `.irismd/` directory with agents, skills, templates
+
+### FR-4: Slash Commands
+
+- FR-4.1: Each tool SHALL have access to `/irismd-master-agent` (Master Agent)
+- FR-4.2: Each tool SHALL have access to `/irismd-inception-agent`
+- FR-4.3: Each tool SHALL have access to `/irismd-construction-agent`
+- FR-4.4: Each tool SHALL have access to `/irismd-operations-agent`
+
+### FR-5: Installation Manifest
+
+- FR-5.1: System SHALL create `.irismd/manifest.yaml` after installation
+- FR-5.2: Manifest SHALL record installed flow, version, timestamp, and tools
+
+---
+
+## Non-Functional Requirements
+
+### NFR-1: Usability
+
+- Installation SHALL complete in under 30 seconds
+- CLI SHALL provide clear progress feedback
+- CLI SHALL use color-coded output for status
+
+### NFR-2: Compatibility
+
+- System SHALL work on macOS, Linux, and Windows
+- System SHALL work with Node.js 18+
+- System SHALL not require global npm installation
+
+### NFR-3: Extensibility
+
+- New tool installers SHALL be addable via factory pattern
+- New flows SHALL be addable without modifying core installer
+
+---
+
+## Acceptance Criteria
+
+### AC-1: Installation
+
+- GIVEN a project with Claude Code available
+- WHEN user runs `npx irismd install`
+- THEN installer detects Claude Code and offers it for selection
+
+### AC-2: Slash Commands
+
+- GIVEN a successful installation to Claude Code
+- WHEN user types `/irismd-master-agent` in Claude Code
+- THEN Master Agent activates
+
+### AC-3: Multi-Tool
+
+- GIVEN a project with both Claude Code and Cursor
+- WHEN user selects both tools during installation
+- THEN both tools receive slash commands and can invoke agents

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/system-context.md

@@ -0,0 +1,170 @@
+# System Context: Agentic Coding Tool Integration
+
+## Overview
+
+This document defines the boundaries and integration points for the Agentic Coding Tool Integration system.
+
+---
+
+## System Boundary
+
+```text
+┌────────────────────────────────────────────────────────────────────┐
+│                         External Systems                            │
+│  ┌────────────┐  ┌────────────┐  ┌───────────────┐  ┌───────────┐ │
+│  │Claude Code │  │   Cursor   │  │GitHub Copilot │  │Antigravity│ │
+│  │  (Tool)    │  │   (Tool)   │  │    (Tool)     │  │  (Tool)   │ │
+│  └─────┬──────┘  └─────┬──────┘  └──────┬────────┘  └─────┬─────┘ │
+│        │               │                │                  │       │
+└────────┼───────────────┼────────────────┼──────────────────┼───────┘
+         │               │                │                  │
+         │  Slash Commands / Rules / Agents                  │
+         │               │                │                  │
+┌────────▼───────────────▼────────────────▼──────────────────▼───────┐
+│                      irismd CLI                                    │
+│  ┌─────────────────────────────────────────────────────────────┐   │
+│  │                    Installer System                          │   │
+│  │  ┌───────────────┐  ┌───────────────────────────────────┐   │   │
+│  │  │InstallerFactory│─▶│ Tool-Specific Installers          │   │   │
+│  │  └───────────────┘  │ (Claude, Cursor, Copilot,         │   │   │
+│  │                      │  Antigravity, Windsurf, etc.)     │   │   │
+│  │                      └───────────────────────────────────┘   │   │
+│  └─────────────────────────────────────────────────────────────┘   │
+│                                │                                    │
+│                                │ Installs                           │
+│                                ▼                                    │
+│  ┌─────────────────────────────────────────────────────────────┐   │
+│  │                    Project Directory                         │   │
+│  │  ┌─────────────┐  ┌───────────────────┐  ┌──────────────┐   │   │
+│  │  │  .irismd/  │  │.claude/commands/  │  │memory-bank/  │   │   │
+│  │  │  (runtime)  │  │.claude/agents/    │  │ (artifacts)  │   │   │
+│  │  │             │  │.cursor/rules/     │  │              │   │   │
+│  │  │             │  │.github/agents/    │  │              │   │   │
+│  │  │             │  │.agent/agents/     │  │              │   │   │
+│  │  └─────────────┘  └───────────────────┘  └──────────────┘   │   │
+│  └─────────────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## External Systems
+
+### Claude Code
+
+- **Type**: AI-powered coding assistant
+- **Integration**: Slash commands in `.claude/commands/` + agents in `.claude/agents/`
+- **Interface**: `/irismd*` commands and Claude-invoked agents
+- **Features**: Supports both user-invoked commands and AI-delegated agents
+
+### Cursor
+
+- **Type**: AI-powered code editor
+- **Integration**: Rules in `.cursor/rules/` (MDC format with frontmatter)
+- **Interface**: Rules with `alwaysApply: true` for automatic activation
+
+### GitHub Copilot
+
+- **Type**: AI pair programmer
+- **Integration**: Workspace agents in `.github/agents/` (`.agent.md` format)
+- **Interface**: `@irismd*` agent invocation
+
+### Google Antigravity
+
+- **Type**: AI-powered IDE
+- **Integration**: Agents in `.agent/agents/`
+- **Interface**: Agent-based invocation
+
+---
+
+## Internal Components
+
+### CLI Entry Point
+
+- **Component**: `bin/cli.js`
+- **Responsibility**: Parse commands, display UI, orchestrate installation
+
+### Installer Factory
+
+- **Component**: `lib/InstallerFactory.js`
+- **Responsibility**: Create appropriate installer based on detected tools
+
+### Tool Installers
+
+- **Components**: `ClaudeInstaller.js`, `CursorInstaller.js`, `CopilotInstaller.js`, `AntigravityInstaller.js`
+- **Responsibility**: Tool-specific installation logic
+- **Note**: ClaudeInstaller and CopilotInstaller install both commands and agents from the same source
+
+---
+
+## Data Flow
+
+### Installation Flow
+
+```text
+User runs `npx irismd install`
+         │
+         ▼
+CLI detects available tools
+         │
+         ▼
+InstallerFactory creates appropriate installer(s)
+         │
+         ▼
+Installer copies:
+  - Command/rule files to tool directory
+  - Agent files (for Claude Code: .claude/agents/, for Copilot: .github/agents/)
+  - .irismd/ runtime files
+  - memory-bank/ structure (via project-init)
+         │
+         ▼
+Installation manifest created
+```
+
+---
+
+## Integration Contracts
+
+### File Formats
+
+Each tool expects specific file formats:
+
+**Claude Code Commands** (`.claude/commands/*.md`)
+
+- Filename as command name
+- Content as system prompt for the agent
+
+**Claude Code Agents** (`.claude/agents/*.md`)
+
+- Same content as commands, sourced from `commands/` folder
+- Content references full agent definition in `.irismd/aidlc/agents/`
+
+**Cursor Rules** (`.cursor/rules/*.mdc`)
+
+- YAML frontmatter with `alwaysApply: true`
+- MDC format content
+
+**GitHub Copilot Agents** (`.github/agents/*.agent.md`)
+
+- Markdown content with agent definition
+
+**Google Antigravity Agents** (`.agent/agents/*.md`)
+
+- Markdown content with agent definition
+
+### Directory Conventions
+
+| Tool | Commands/Rules Path | Agents/Subagents Path |
+|------|---------------------|----------------------|
+| Claude Code | `.claude/commands/` | `.claude/agents/` |
+| Cursor | `.cursor/rules/` (MDC) | — |
+| GitHub Copilot | — | `.github/agents/` |
+| Google Antigravity | — | `.agent/agents/` |
+
+---
+
+## Constraints
+
+- Tools may or may not be installed on user's system
+- Installation must be idempotent (can run multiple times safely)
+- No tool-specific configuration files modified (only irismd files added)

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/antigravity-installer/unit-brief.md

@@ -0,0 +1,156 @@
+# Unit Brief: Google Antigravity Installer
+
+## Overview
+
+The Google Antigravity Installer handles installation of irismd agents into Antigravity's `.agent/agents/` directory.
+
+---
+
+## Scope
+
+### In Scope
+
+- Google Antigravity detection
+- Agent file installation to `.agent/agents/`
+
+### Out of Scope
+
+- Base installation logic (handled by ToolInstaller)
+- Other tool installations
+
+---
+
+## Technical Context
+
+### File Structure
+
+```text
+src/lib/installers/
+└── AntigravityInstaller.js
+```
+
+### Target Installation Path
+
+```text
+project-root/
+└── .agent/
+    └── agents/
+        ├── irismd-master-agent.md
+        ├── irismd-inception-agent.md
+        ├── irismd-construction-agent.md
+        └── irismd-operations-agent.md
+```
+
+---
+
+## Implementation Details
+
+### AntigravityInstaller Class
+
+Extends `ToolInstaller` with standard behavior (no custom transformations needed).
+
+```javascript
+const ToolInstaller = require('./ToolInstaller');
+
+class AntigravityInstaller extends ToolInstaller {
+    get key() {
+        return 'antigravity';
+    }
+
+    get name() {
+        return 'Google Antigravity';
+    }
+
+    get commandsDir() {
+        return '.agent/agents';
+    }
+
+    get detectPath() {
+        return '.agent';
+    }
+}
+
+module.exports = AntigravityInstaller;
+```
+
+### Properties
+
+| Property | Value | Description |
+|----------|-------|-------------|
+| `key` | `'antigravity'` | Unique identifier for factory lookup |
+| `name` | `'Google Antigravity'` | Display name in CLI |
+| `commandsDir` | `'.agent/agents'` | Where to install agent files |
+| `detectPath` | `'.agent'` | Directory to check for detection |
+
+### Detection Logic
+
+Google Antigravity is detected if `.agent/` directory exists in the project root. This directory is created when Antigravity initializes a workspace.
+
+### Command Installation
+
+Inherits `installCommands()` from `ToolInstaller`:
+
+1. Creates `.agent/agents/` if it doesn't exist
+2. Copies all `.md` files from `src/flows/{flow}/commands/`
+3. Prefixes each file with `irismd-`
+
+---
+
+## Google Antigravity Reference
+
+Google Antigravity is an agentic development platform launched by Google in November 2025.
+
+### Directory Structure
+
+```text
+.agent/
+├── agents/        # Agent definitions
+├── rules/         # Project-level rules
+└── workflows/     # Automation workflows
+```
+
+### Key Concepts
+
+- **Agents**: Markdown files that define AI agent behavior
+- **Rules**: Guidelines that agents follow during code generation
+- **Workflows**: Multi-step automation sequences
+
+### Configuration Locations
+
+| Type | Location |
+|------|----------|
+| Project agents | `.agent/agents/` |
+| Project rules | `.agent/rules/` |
+| Project workflows | `.agent/workflows/` |
+| Global config | `~/.gemini/antigravity/` |
+
+---
+
+## Acceptance Criteria
+
+### AC-1: Detection
+
+- GIVEN a project with `.agent/` directory
+- WHEN detectTools() runs
+- THEN Google Antigravity is listed as detected
+
+### AC-2: Installation
+
+- GIVEN user selects Google Antigravity
+- WHEN installation completes
+- THEN `.agent/agents/irismd-*.md` files exist
+- AND files contain agent definitions
+
+### AC-3: Non-Detection
+
+- GIVEN a project without `.agent/` directory
+- WHEN detectTools() runs
+- THEN Google Antigravity is NOT listed as detected
+- BUT user can still select it manually
+
+### AC-4: No Conflicts
+
+- GIVEN `.agent/` directory exists for other purposes
+- WHEN irismd installs to `.agent/agents/`
+- THEN existing files in `.agent/` are not modified
+- AND only `irismd-` prefixed files are created