@williambeto/ai-workflow 2.4.9 → 2.6.4

package/docs/getting-started/quickstart.md

@@ -1,117 +0,0 @@
-# Quickstart — 5-Minute Guide
-
-Get AI Workflow Kit running in your project in under 5 minutes.
-
-## Prerequisites
-
-- **Node.js** ≥ 18 (LTS recommended)
-- **npm** ≥ 9
-- **Git** initialized repository
-- **OpenCode** runtime installed ([opencode.ai](https://opencode.ai)) — required for `aw run` and `aw execute`
-
-## Step 1: Install
-
-```bash
-npm install -g @williambeto/ai-workflow
-```
-
-Verify the installation:
-
-```bash
-ai-workflow doctor
-```
-
-Expected output:
-
-```
-✔ ai-workflow CLI found
-✔ Node.js version compatible
-✔ Git repository detected
-```
-
-## Step 2: Initialize your project
-
-Navigate to your project root and run:
-
-```bash
-cd your-project
-ai-workflow init
-```
-
-This installs the workflow assets into your project:
-
-```
-✔ Created .ai-workflow/
-✔ Created opencode.jsonc
-✔ Updated .gitignore
-✔ Installed 6 agents, 25 skills, 14 commands, 11 policies
-```
-
-### Init options
-
-| Flag | Description |
-| --- | --- |
-| `--yes` | Auto-approve all confirmations |
-| `--dry-run` | Preview changes without writing files |
-| `--profile=full` | Install with examples (default: `standard`) |
-| `--gemini` | Also install Gemini adapter config |
-| `--claude` | Also install Claude adapter config |
-| `--antigravity` | Also install Antigravity adapter config |
-
-## Step 3: Make a request
-
-With OpenCode running, ask Atlas for a natural software outcome:
-
-```bash
-ai-workflow execute "Add a health check endpoint to the Express API"
-```
-
-Atlas will:
-1. Classify the request intent
-2. Select the appropriate mode (`quick`, `standard`, or `full`)
-3. Create a safe branch (never writes to `main`)
-4. Delegate to the right agent (e.g., Astra for implementation)
-5. Run observed validation (tests, lint, build)
-6. Return a structured delivery summary
-
-## Step 4: Collect evidence
-
-After work is complete, collect validation evidence:
-
-```bash
-ai-workflow collect-evidence --mode=standard
-```
-
-Expected output:
-
-```
---- Delivery Summary ---
-Status: COMPLETED
-Branch: feat/health-check
-Changes: src/routes/health.js, tests/health.test.js
-Validation: npm,test: PASS
-Known limitations: None recorded
-```
-
-## Completion statuses
-
-| Status | Meaning |
-| --- | --- |
-| `COMPLETED` | All validation passed |
-| `COMPLETED_WITH_NOTES` | Passed with recorded limitations |
-| `BLOCKED` | Validation failed or approval missing |
-
-## Visual & accessibility evidence
-
-If your project uses visual validation or accessibility audits, install the required dependencies:
-
-```bash
-npm install -D playwright @playwright/test axe-core
-npx playwright install chromium
-```
-
-## Next steps
-
-- [CLI Reference](../../dist-assets/docs/cli-reference.md) — all commands, flags, and examples
-- [Troubleshooting](./troubleshooting.md) — common errors and FAQ
-- [Upgrading to v2](./upgrading-to-v2.md) — migration guide from v1

package/docs/getting-started/troubleshooting.md

@@ -1,123 +0,0 @@
-# Troubleshooting
-
-Common issues, solutions, and frequently asked questions for AI Workflow Kit.
-
-## Common Errors
-
-### `Error: Not a git repository`
-
-**Cause:** `ai-workflow` requires a Git-initialized project directory.
-
-**Solution:**
-```bash
-git init
-ai-workflow init
-```
-
-### `Error: ai-workflow must not run init inside its own repository`
-
-**Cause:** You are running `ai-workflow init` inside the AI Workflow Kit source repository itself.
-
-**Solution:** Navigate to your consumer project directory before running `init`.
-
-### `Error: Current branch is protected (main/master)`
-
-**Cause:** The Branch Gate prevents writing directly to protected branches.
-
-**Solution:** The workflow will automatically create a feature branch. If on a dirty working tree, commit or stash changes first:
-```bash
-git stash
-ai-workflow execute "your request"
-```
-
-### `Status: BLOCKED — FAIL_QUALITY_GATE`
-
-**Cause:** Validation commands (`npm test`, `npm run lint`, `npm run build`) failed.
-
-**Solution:**
-1. Check the delivery summary for which command failed
-2. Fix the failing tests or lint errors
-3. Re-run: `ai-workflow collect-evidence --mode=standard`
-
-### `Error: opencode not found` or `ENOENT: opencode`
-
-**Cause:** The OpenCode runtime is not installed or not in your PATH.
-
-**Solution:**
-1. Install OpenCode from [opencode.ai](https://opencode.ai)
-2. Verify: `which opencode`
-3. If installed but not found, add it to your PATH
-
-### `BLOCKED — Delivery decision is blocking: BLOCK_STACK_CONFLICT`
-
-**Cause:** The request asks for a framework or stack that conflicts with the existing project setup.
-
-**Solution:** Be explicit about the target stack in your request, or use the `explicitApprovals` mechanism to override.
-
-### `Fidelity Violation: Design System token mismatch`
-
-**Cause:** CSS files with more than 200 characters of rules were detected without CSS custom properties (`var(--...)`), and the `frontend-design-system` skill is installed.
-
-**Solution:**
-- Add CSS custom properties to your stylesheets, or
-- Add explicit approval `no-css-vars` to bypass for simple/legacy stylesheets
-
-## Frequently Asked Questions
-
-### 1. Can I use AI Workflow Kit without OpenCode?
-
-The `init`, `doctor`, `clean`, `validate`, and `collect-evidence` commands work without OpenCode. However, `run` and `execute` require the OpenCode runtime to orchestrate agent workflows.
-
-### 2. Does `aw init` modify my existing code?
-
-No. It only creates workflow configuration files (`.ai-workflow/`, `opencode.jsonc`, symlinks) and appends entries to `.gitignore`. Your source code is never modified by `init`.
-
-### 3. How do I uninstall AI Workflow Kit from a project?
-
-```bash
-ai-workflow clean --yes
-```
-
-This removes `.ai-workflow/`, `opencode.jsonc`, `.workflow-state.json`, and the `opencode` symlink. Add `--purge-agents` to also remove `.agents/`. Use `--dry-run` to preview what will be deleted.
-
-> [!WARNING]
-> **Limitations:** `clean` deletes `opencode.jsonc` entirely. If you had pre-existing configurations or custom additions merged into `opencode.jsonc` before or during initialization, they will not be restored to their original state. Back up any custom `opencode.jsonc` configs before cleaning.
-
-### 4. Which AI platforms are supported?
-
-AI Workflow Kit includes adapters for:
-- **Gemini** (`--gemini`)
-- **Claude** (`--claude`)
-- **Codex** (`--codex`)
-- **Antigravity** (`--antigravity`)
-
-### 5. What is the difference between `standard` and `full` profiles?
-
-| Feature | `standard` | `full` |
-| --- | --- | --- |
-| Agents, skills, commands, policies | ✅ | ✅ |
-| Example specs and templates | ❌ | ✅ |
-| Default | ✅ | ❌ |
-
-### 6. Can agents push directly to `main`?
-
-No. The Branch Gate policy enforces that all write operations happen on feature branches (`feat/*`, `fix/*`, `chore/*`, `docs/*`). Direct pushes to `main` or `master` are blocked.
-
-### 7. How do I update to a newer version?
-
-```bash
-npm install -g @williambeto/ai-workflow@latest
-ai-workflow init --force
-```
-
-See [Upgrading to v2](./upgrading-to-v2.md) for detailed migration instructions.
-
-## Reporting Issues
-
-- **Security vulnerabilities:** Follow the process in [SECURITY.md](../../.github/SECURITY.md)
-- **Bug reports:** Open an issue in the project's GitHub repository with:
-  - AI Workflow Kit version (`ai-workflow --version`)
-  - Node.js version (`node --version`)
-  - Operating system
-  - Steps to reproduce
-  - Expected vs actual behavior

package/docs/getting-started/upgrading-to-v2.md

@@ -1,62 +0,0 @@
-# Upgrading to version 2
-
-Version `2.x` is a breaking public line from the previous `1.x` line. Test upgrades in a disposable or non-critical consumer before replacing an existing installation.
-
-## Upgrade path
-
-1. Record the installed version and back up project-level runtime files.
-2. Remove the global package when applicable:
-
-   ```bash
-   npm uninstall -g @williambeto/ai-workflow
-   ```
-
-3. Install the current public release:
-
-   ```bash
-   npm install -g @williambeto/ai-workflow@latest
-   ```
-
-4. Inspect initialization before applying it:
-
-   For first-time or pre-installation usage:
-   ```bash
-   npx @williambeto/ai-workflow init --dry-run
-   npx @williambeto/ai-workflow init --yes
-   ```
-
-   After installing AI Workflow Kit locally in your project:
-   ```bash
-   npx aw init --dry-run
-   npx aw init --yes
-   npx aw doctor
-   ```
-
-## Main changes in version 2
-
-- OpenCode-first runtime with six primary ownership roles.
-- Proportional `quick`, `standard`, and `full` modes.
-- Observed validation, false-success prevention, and bounded remediation.
-- Concise quick/standard summaries without mandatory owner JSON, fixed delivery filenames, or `EVIDENCE.json`.
-- Full/release/audit/security workflows may persist structured evidence when traceability is required.
-- Semantic Product Truthfulness guidance without keyword-only enforcement.
-- Consumer files managed under `.ai-workflow/`.
-- Optional Codex, Claude Code, and Gemini adapter assets with documented limitations.
-
-## Breaking changes
-
-- Generated assets and configuration may differ substantially from `1.x`.
-- Legacy paths, taxonomies, aliases, and obsolete documentation are not retained as active sources.
-- Consumer-managed files should be reviewed before accepting initialization changes.
-- Direct prompts and provider behavior remain subject to the documented known limitations.
-
-## Rollback
-
-If you need to return to the previous public line during migration testing, install the known `1.x` version explicitly:
-
-```bash
-npm uninstall -g @williambeto/ai-workflow
-npm install -g @williambeto/ai-workflow@1.19.1
-```
-
-Restore backed-up project files when initialization changed consumer integrations.

package/src/adapters/index.js

@@ -1,4 +0,0 @@
-export { GeminiAdapter } from "./platforms/gemini.js";
-export { ClaudeAdapter } from "./platforms/claude.js";
-export { CodexAdapter } from "./platforms/codex.js";
-export { AntigravityAdapter } from "./platforms/antigravity.js";

package/src/adapters/platforms/antigravity.js

@@ -1,382 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-import { COMPLETION_STATUS_TEXT } from "../../core/statuses.js";
-
-/**
- * Maps OpenCode agent names to primary agent roles.
- * @type {Record<string, string>}
- */
-const PERSONA_MAPPING = {
-  "atlas": "Atlas",
-  "orion": "Orion",
-  "sage": "Sage",
-  "nexus": "Nexus",
-  "astra": "Astra",
-  "sage-validation": "Sage",
-  "orion-release": "Orion",
-  "orion-deploy": "Orion",
-  "nexus-discovery": "Nexus",
-  "phoenix": "Phoenix"
-};
-
-/**
- * Antigravity Adapter - Transforms OpenCode .md to Antigravity Skill format and manages .agents/ integration.
- */
-export class AntigravityAdapter {
-  constructor({ cwd }) {
-    this.cwd = cwd;
-  }
-
-  /**
-   * Transforms an OpenCode agent or specialized skill file to an Antigravity Skill.
-   * @param {string} filePath - Path to the source .md file.
-   * @returns {Promise<{content: string, name: string}>}
-   */
-  async transform(filePath) {
-    const content = await fs.readFile(filePath, "utf8");
-    const fileName = path.basename(filePath, ".md") === "SKILL" 
-      ? path.basename(path.dirname(filePath)) 
-      : path.basename(filePath, ".md");
-      
-    const persona = PERSONA_MAPPING[fileName.toLowerCase()] || "Astra";
-    
-    // Check if already has frontmatter
-    if (content.trim().startsWith("---")) {
-      return { content, name: fileName };
-    }
-
-    // Extract description from the first paragraph after the title
-    const descriptionMatch = content.match(/^# .*\n\n(.*)/m);
-    const description = descriptionMatch ? descriptionMatch[1].trim() : `Specialized agent for ${fileName}.`;
-
-    const skillContent = `---
-name: ${fileName}
-description: ${description}
----
-# ${persona} Persona
-
-${content}
-
-##  Completion Contract (Mandatory)
-Every task completion MUST provide the following payload:
-1. **Status**: ${COMPLETION_STATUS_TEXT}
-2. **Scope reviewed**: Brief summary of what was analyzed.
-3. **Findings**: Evidence-based discoveries.
-4. **Files affected**: List of all concrete paths modified or created.
-5. **Validation/evidence**: Commands run and their results.
-6. **Risks/notes**: Any caveats or technical debt introduced.
-7. **Required manager action**: Clear next step for the orchestrator.
-8. **Can manager continue**: [yes/no]
-`;
-
-    return {
-      content: skillContent,
-      name: fileName
-    };
-  }
-
-  /**
-   * Deploys transformed skills and agents to their respective directories.
-   * Also orchestrates the .antigravity/ native integration.
-   */
-  async deploy(transformedItems, installRoot = ".ai-workflow") {
-    const agentsDir = path.join(this.cwd, installRoot, "opencode/agents");
-    const skillsDir = path.join(this.cwd, installRoot, "opencode/skills");
-    
-    await fs.mkdir(agentsDir, { recursive: true });
-    await fs.mkdir(skillsDir, { recursive: true });
-
-    for (const item of transformedItems) {
-      const isAgent = PERSONA_MAPPING[item.name.toLowerCase()];
-      const targetDir = isAgent ? agentsDir : path.join(skillsDir, item.name);
-      const fileName = isAgent ? `${item.name}.md` : "SKILL.md";
-      
-      const absoluteTargetDir = isAgent ? agentsDir : targetDir;
-      await fs.mkdir(absoluteTargetDir, { recursive: true });
-      await fs.writeFile(path.join(absoluteTargetDir, fileName), item.content);
-    }
-    
-    // Deploy native Antigravity extensions (.antigravity/)
-    await this.deployNativeExtensions(installRoot);
-
-    // Also deploy root ANTIGRAVITY.md if it doesn't exist
-    await this.deployInstructions();
-  }
-
-  /**
-   * Orchestrates the .agents/ directory with copies of .ai-workflow/ assets.
-   * Using hard copies instead of symlinks ensures native discovery across all platforms.
-   */
-  async deployNativeExtensions(installRoot = ".ai-workflow") {
-    const antigravityDir = path.join(this.cwd, ".agents");
-    const antigravityAgents = path.join(antigravityDir, "agents");
-    const antigravitySkills = path.join(antigravityDir, "skills");
-    const antigravityCommands = path.join(antigravityDir, "commands");
-
-    await fs.mkdir(antigravityAgents, { recursive: true });
-    await fs.mkdir(antigravitySkills, { recursive: true });
-    await fs.mkdir(antigravityCommands, { recursive: true });
-
-    const getUrls = (targetPath) => {
-      const linuxUrl = pathToFileURL(targetPath).href;
-      const urls = [linuxUrl];
-      
-      if (process.platform === "linux" && process.env.WSL_DISTRO_NAME) {
-        const distro = process.env.WSL_DISTRO_NAME;
-        const normalizedPath = targetPath.replaceAll("\\", "/");
-        urls.push(`file://wsl.localhost/${distro}${normalizedPath}`);
-        urls.push(`file:///wsl.localhost/${distro}${normalizedPath}`);
-      }
-      
-      return urls.join("\n");
-    };
-
-    const toolNames = [
-      "send_message",
-      "find_by_name",
-      "grep_search",
-      "view_file",
-      "list_dir",
-      "read_url_content",
-      "search_web",
-      "schedule",
-      "multi_replace_file_content",
-      "replace_file_content",
-      "write_to_file",
-      "run_command",
-      "manage_task",
-      "define_subagent",
-      "invoke_subagent",
-      "manage_subagents",
-      "call_mcp_tool"
-    ];
-
-    const systemPromptConfig = {
-      "includeSections": [
-        "user_information",
-        "mcp_servers",
-        "skills",
-        "subagent_reminder",
-        "messaging",
-        "artifacts",
-        "user_rules"
-      ]
-    };
-
-    // 1. Deploy Primary Agents to .agents/agents/{agent_name}/
-    const sourceAgentsDir = path.join(this.cwd, installRoot, "opencode/agents");
-    const agentFiles = await fs.readdir(sourceAgentsDir).catch(() => []);
-
-    const AGENTS_INFO = {
-      "atlas": { name: "Atlas", description: "Router and workflow coordinator for AI Workflow Kit" },
-      "nexus": { name: "Nexus", description: "Discovery, requirement, scope, and specification owner" },
-      "orion": { name: "Orion", description: "Planning, PR sequencing, release, and deployment strategy owner" },
-      "astra": { name: "Astra", description: "Implementation owner for incremental, scoped changes" },
-      "sage": { name: "Sage", description: "Audit, validation, evidence, and quality gate owner" },
-      "phoenix": { name: "Phoenix", description: "Remediation and regression recovery owner" }
-    };
-
-    for (const file of agentFiles) {
-      if (!file.endsWith(".md")) continue;
-      const lowercaseName = path.basename(file, ".md").toLowerCase();
-      const info = AGENTS_INFO[lowercaseName];
-      if (!info) continue;
-
-      const agentFolder = path.join(antigravityAgents, lowercaseName);
-      await fs.mkdir(agentFolder, { recursive: true });
-
-      // Copy Markdown file to the agent's folder
-      const content = await fs.readFile(path.join(sourceAgentsDir, file), "utf8");
-      const mdTarget = path.join(agentFolder, `${lowercaseName}.md`);
-      await fs.writeFile(mdTarget, content);
-
-      // Generate agent.json
-      const agentJson = {
-        name: lowercaseName,
-        description: info.description,
-        hidden: false,
-        config: {
-          customAgent: {
-            systemPromptSections: [
-              {
-                title: "Agent System Instructions",
-                content: `You are ${info.name}, the ${lowercaseName === "astra" ? "implementation" : lowercaseName} owner.\n\nFollow the contract instructions in:\n${getUrls(mdTarget)}`
-              }
-            ],
-            toolNames,
-            systemPromptConfig
-          }
-        }
-      };
-      await fs.writeFile(path.join(agentFolder, "agent.json"), JSON.stringify(agentJson, null, 2));
-    }
-
-    // 2. Deploy Subagents to .agents/agents/{subagent_name}/
-    const SUBAGENTS_INFO = {
-      "Architecture-Specialist": { description: "Select the simplest architecture that safely satisfies current requirements", skill: "architecture" },
-      "Backend-Engineer": { description: "Support safe PHP/Node/Python backend changes for APIs and persistence", skill: "backend-development" },
-      "Deployment-Specialist": { description: "Plan, review, or validate deployment, release, and production-readiness", skill: "deployment" },
-      "Design-Specialist": { description: "Apply practical design principles to keep solutions simple and maintainable", skill: "design-principles" },
-      "Docs-Engineer": { description: "Write or improve project documentation, READMEs, guides, and prompts", skill: "documentation" },
-      "Frontend-Engineer": { description: "Implement or review frontend changes involving UI, state, routing, and accessibility", skill: "frontend-development" },
-      "Full-Stack-Engineer": { description: "Coordinate frontend and backend changes as one coherent, testable increment", skill: "full-stack-development" },
-      "Token-Economist": { description: "Reduce context size while preserving information required for safe execution", skill: "optimize-tokens" },
-      "PR-Manager": { description: "Plan, implement, review, or validate small pull requests while preserving scope", skill: "pr-workflow" },
-      "Discovery-Analyst": { description: "Clarify ambiguous requests into actionable problem statements and success outcomes", skill: "product-discovery" },
-      "Product-Planner": { description: "Turn clarified needs into scoped requirements with acceptance-ready outcomes", skill: "product-planning" },
-      "Memory-Guardian": { description: "Manage discoverable project memory for durable decisions and recurring corrections", skill: "project-memory" },
-      "Prompt-Engineer": { description: "Expert in creating and refining prompts for AI agents and workflows", skill: "prompt-engineer" },
-      "QA-Engineer": { description: "Design, review, or improve tests, acceptance criteria, and validation evidence", skill: "qa-workflow" },
-      "Refactoring-Specialist": { description: "Improve code/document structure safely while preserving behavior", skill: "refactoring" },
-      "Release-Specialist": { description: "Prepare release readiness decisions with explicit gates and evidence", skill: "release-workflow" },
-      "SDD-Specialist": { description: "Convert approved requirements into explicit, testable specification artifacts", skill: "spec-driven-development" },
-      "Technical-Leader": { description: "Make technical decisions, review architecture, and identify trade-offs", skill: "technical-leadership" },
-      "UI-UX-Engineer": { description: "Improve usability and interface clarity without introducing unnecessary complexity", skill: "ui-ux-design" }
-    };
-
-    for (const [name, subInfo] of Object.entries(SUBAGENTS_INFO)) {
-      const lowercaseSubagentName = name.toLowerCase();
-      const subagentFolder = path.join(antigravityAgents, lowercaseSubagentName);
-      await fs.mkdir(subagentFolder, { recursive: true });
-
-      const skillPath = path.join(antigravitySkills, subInfo.skill, "SKILL.md");
-
-      const subagentJson = {
-        name: lowercaseSubagentName,
-        description: subInfo.description,
-        hidden: false,
-        config: {
-          customAgent: {
-            systemPromptSections: [
-              {
-                title: "Agent System Instructions",
-                content: `You are ${name}.\n\nFollow the contract instructions in:\n${getUrls(skillPath)}`
-              }
-            ],
-            toolNames,
-            systemPromptConfig
-          }
-        }
-      };
-      await fs.writeFile(path.join(subagentFolder, "agent.json"), JSON.stringify(subagentJson, null, 2));
-    }
-
-    // 3. Copy Skills
-    const sourceSkillsDir = path.join(this.cwd, installRoot, "opencode/skills");
-    const skillFolders = await fs.readdir(sourceSkillsDir).catch(() => []);
-    for (const folder of skillFolders) {
-      const skillSource = path.join(sourceSkillsDir, folder, "SKILL.md");
-      if (await this.exists(skillSource)) {
-        await fs.mkdir(path.join(antigravitySkills, folder), { recursive: true });
-        const content = await fs.readFile(skillSource, "utf8");
-        await fs.writeFile(path.join(antigravitySkills, folder, "SKILL.md"), content);
-      }
-    }
-
-    // 4. Copy Commands (from dist-assets/commands)
-    const sourceCommandsDir = path.join(this.cwd, installRoot, "opencode/commands");
-    if (await this.exists(sourceCommandsDir)) {
-      const commandFiles = await fs.readdir(sourceCommandsDir).catch(() => []);
-      for (const file of commandFiles) {
-        if (!file.endsWith(".md") && !file.endsWith(".toml")) continue;
-        const content = await fs.readFile(path.join(sourceCommandsDir, file), "utf8");
-        await fs.writeFile(path.join(antigravityCommands, file), content);
-      }
-    }
-
-    // 5. Copy governance policy into .agents/docs/policies/ so the relative
-    //    link ../../docs/policies/SKILLS_COMMON_GOVERNANCE.md in each
-    //    .agents/skills/{skill}/SKILL.md resolves correctly.
-    const sourcePoliciesDir = path.join(this.cwd, installRoot, "opencode", "docs", "policies");
-    const antigravityPolicies = path.join(antigravityDir, "docs", "policies");
-    if (await this.exists(sourcePoliciesDir)) {
-      await fs.mkdir(antigravityPolicies, { recursive: true });
-      const policyFiles = await fs.readdir(sourcePoliciesDir).catch(() => []);
-      for (const file of policyFiles) {
-        if (!file.endsWith(".md")) continue;
-        const content = await fs.readFile(path.join(sourcePoliciesDir, file), "utf8");
-        await fs.writeFile(path.join(antigravityPolicies, file), content);
-      }
-    }
-
-    // 6. Inject project settings.json
-    const settingsPath = path.join(antigravityDir, "settings.json");
-    if (!(await this.exists(settingsPath))) {
-      const settings = {
-        model: { name: "auto" },
-        ui: { theme: "Ayu" }
-      };
-      await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));
-    }
-  }
-
-  async exists(p) {
-    try {
-      await fs.access(p);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Deploys the main ANTIGRAVITY.md and .antigravityignore instructions to the project root.
-   */
-  async deployInstructions() {
-    const targetPath = path.join(this.cwd, "ANTIGRAVITY.md");
-    const ignorePath = path.join(this.cwd, ".antigravityignore");
-    
-    // Deploy ANTIGRAVITY.md if it doesn't exist
-    try {
-      await fs.access(targetPath);
-    } catch {
-      const instructions = `# AI Workflow Kit - Engineering Governance
-
-## Mandate: Atlas Authority Protocol
-All architectural changes must align with the specifications issued by the **Specification Authority** (./specs).
-
-## Ternary Architecture
-- **Root:** Orchestration and config.
-- **.ai-workflow/:** Implementation (The Muscle).
-- **./specs:** Specifications (The Brain).
-
-## Branch Gates
-- **main Branch:** READ-ONLY.
-- **Validation:** Merges require successful observed validation; full/release workflows may persist EVIDENCE.json.
-
-## Primary Agents
-- **Atlas (Orchestrator)**
-- **Orion (Strategist)**
-- **Sage (Auditor)**
-- **Nexus (Spec Architect)**
-- **Astra (Developer)**
-- **Phoenix (Healer)**
-
-## Operational Preferences
-- Use \`token-economy\` and \`minimal-context\` skills.
-- **Native Discovery**: This project uses workspace-specific extensions in \`.agents/\`.
-- **Workflow Entry**: Use \`/atlas\` to begin any task.
-`;
-      await fs.writeFile(targetPath, instructions);
-    }
-
-    // Deploy .antigravityignore if it doesn't exist
-    try {
-      await fs.access(ignorePath);
-    } catch {
-      const ignoreContent = `.ai-workflow/
-.ai-workflow-backups/
-node_modules/
-.git/
-EVIDENCE.json
-*.tgz
-*.zip
-*.tar
-.agents/tmp/
-.agents/history/
-`;
-      await fs.writeFile(ignorePath, ignoreContent);
-    }
-  }
-}