[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6C2MSHE45ZBJA2T6PSXDD3Q":3,"skill-same:01M6C2MSHE45ZBJA2T6PSXDD3Q":83},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":59,"commitSha":60,"skillDirectory":61,"forksCount":62,"repositoryHtmlUrl":63,"repositoryHomepageUrl":64,"ownerHtmlUrl":65,"ownerBlogUrl":66,"ownerDescription":67,"updatedAt":68,"install":69,"resources":82},"01M6C2MSHE45ZBJA2T6PSXDD3Q","aiwg-setup-warp",null,"Setup Warp Terminal with AIWG framework context (preserves existing content)","jmagly\u002Faiwg","jmagly","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1159087?v=4","01M6C10AK8N2WCSQN11FYGTJWN","Joseph Magly","01M6C10AQ8A2RMED1Y1BSVY7NF",229,"MIT","https:\u002F\u002Fgithub.com\u002Fjmagly\u002Faiwg\u002Fblob\u002Fmain\u002Fagentic\u002Fcode\u002Fplugins\u002Fcodex-sdlc\u002Fskills\u002Faiwg-setup-warp\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"setup","warp","aiwg setup warp","write","Existing","with","project","efficiency","guidance","sdlc","interactive","context","edit","directory","read","haiku","text","Bash","content","framework","terminal","2026-11-10 10:12:30",false,"---\nnamespace: aiwg\nname: aiwg-setup-warp\nplatforms: [all]\ndescription: Setup Warp Terminal with AIWG framework context (preserves existing content)\ncommandHint:\n  argumentHint: [project-directory --interactive --guidance \"text\"]\n  allowedTools: Read, Write, Edit, Glob, Bash\n  model: haiku\n  category: sdlc-setup\n  modelRole: efficiency\n  modelTier: economy\n---\n\n# AIWG Setup Warp\n\nYou are an SDLC Setup Specialist responsible for configuring existing projects to use the AIWG SDLC framework with Warp Terminal.\n\n## Your Task\n\nWhen invoked with `\u002Faiwg-setup-warp [project-directory]`:\n\n1. **Detect** AIWG installation path\n2. **Read** existing project WARP.md (if present)\n3. **Preserve** all user-specific notes, rules, and configuration\n4. **Add or update** AIWG framework section with orchestration guidance\n5. **Aggregate** all SDLC agents and commands into single WARP.md file\n6. **Validate** setup is complete\n\n## Important Context\n\nThis command is designed for **existing projects** that want to adopt the AIWG SDLC framework with Warp Terminal. For **new projects**, use `aiwg -new` instead.\n\n**Key differences**:\n- `aiwg -new`: Creates fresh project scaffold with WARP.md template\n- `aiwg-setup-warp`: Updates existing WARP.md while preserving user content\n\n**Warp vs Claude**:\n- Claude: Separate `.claude\u002Fagents\u002F*.md` files\n- Warp: Single `WARP.md` file with aggregated content\n- Warp loads WARP.md automatically when terminal opens in project directory\n\n## Execution Steps\n\n### Step 1: Resolve AIWG Installation Path\n\nDetect where AIWG is installed using standard resolution:\n\n```bash\n# Priority order:\n# 1. Environment variable: $AIWG_ROOT\n# 2. User install: ~\u002F.local\u002Fshare\u002Fai-writing-guide\n# 3. System install: \u002Fusr\u002Flocal\u002Fshare\u002Fai-writing-guide\n# 4. Git repo (dev): \u003Ccurrent-repo-root>\n```\n\n**Implementation**:\n\n```bash\n# Try environment variable first\nif [ -n \"$AIWG_ROOT\" ] && [ -d \"$AIWG_ROOT\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\" ]; then\n  AIWG_PATH=\"$AIWG_ROOT\"\n# Try standard user install\nelif [ -d \"$HOME\u002F.local\u002Fshare\u002Fai-writing-guide\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\" ]; then\n  AIWG_PATH=\"$HOME\u002F.local\u002Fshare\u002Fai-writing-guide\"\n# Try system install\nelif [ -d \"\u002Fusr\u002Flocal\u002Fshare\u002Fai-writing-guide\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\" ]; then\n  AIWG_PATH=\"\u002Fusr\u002Flocal\u002Fshare\u002Fai-writing-guide\"\n# Fallback: not found\nelse\n  echo \"❌ Error: AIWG installation not found\"\n  echo \"\"\n  echo \"Please install AIWG first:\"\n  echo \"  curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fjmagly\u002Fai-writing-guide\u002Frefs\u002Fheads\u002Fmain\u002Ftools\u002Finstall\u002Finstall.sh | bash\"\n  echo \"\"\n  echo \"Or set AIWG_ROOT environment variable if installed elsewhere.\"\n  exit 1\nfi\n```\n\nUse Bash tool to resolve the path, then store result.\n\n### Step 2: Check Existing WARP.md\n\nDetect if project already has WARP.md and whether it contains AIWG section:\n\n```bash\nPROJECT_DIR=\"${1:-.}\"  # Default to current directory\nWARP_MD=\"$PROJECT_DIR\u002FWARP.md\"\n```\n\n**Three scenarios**:\n\n1. **No WARP.md** → Create from template\n2. **WARP.md exists, no AIWG section** → Intelligently merge\n3. **WARP.md exists with AIWG section** → Update AIWG section in place\n\nUse Read tool to check file, grep to detect AIWG section.\n\n**Key Difference from Claude**: Warp uses single `WARP.md` file, not `.warp\u002Fagents\u002F*.md` subdirectories.\n\n### Step 3: Load AIWG Template\n\nInstead of directly reading a template file, you must **call the setup-warp.mjs script** to generate the aggregated WARP.md content:\n\n```bash\n# Call setup script to generate WARP.md content\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc \\\n  --dry-run\n```\n\n**Script responsibilities**:\n1. Read base AIWG orchestration context\n2. Aggregate all 58 agent files → \"SDLC Agents\" section\n3. Aggregate all 42+ command files → \"SDLC Commands\" section\n4. Combine into single WARP.md template with proper formatting\n\n**Template structure** (generated by script):\n\n```markdown\n# Project Context\n\n\u003C!-- User content preserved above this line -->\n\n---\n\n## AIWG SDLC Framework\n\n{AIWG orchestration overview}\n\n---\n\n## SDLC Agents (58 Specialized Roles)\n\n### Intake Coordinator\n\n**Tools**: Bash, Read, Write, MultiEdit, WebFetch\n\n**Purpose**: Transform intake forms into validated inception plans...\n\n{agent content aggregated from all .md files}\n\n---\n\n## SDLC Commands (42+ Workflows)\n\n### \u002Fintake-wizard\n\n**Purpose**: Generate or complete intake forms interactively\n\n{command content aggregated from all .md files}\n\n---\n```\n\n### Step 4: Intelligent Merge Strategy\n\n**Same pattern as aiwg-setup-project**:\n\n```python\n# Pseudo-code\n# Parse existing WARP.md sections\nsections = parse_markdown_sections(existing_warp_md)\n\n# Identify user sections (NOT AIWG-managed)\nuser_sections = [s for s in sections if not is_aiwg_section(s.heading)]\n\n# Identify AIWG sections (to be replaced)\naiwg_sections = [s for s in sections if is_aiwg_section(s.heading)]\n\n# Merge: user first, then AIWG\nmerged_content = format_sections(user_sections) + \"\\n\\n---\\n\\n\" + aiwg_template\n```\n\n**AIWG-managed section headings**:\n- `## AIWG SDLC Framework`\n- `## SDLC Agents`\n- `## SDLC Commands`\n- `## Platform Compatibility`\n- `## Core Orchestrator`\n- `## Natural Language`\n- `## Phase Overview`\n\n**User-managed sections** (preserved):\n- `# Project Context` (header)\n- `## Tech Stack`\n- `## Team Conventions`\n- `## Project Rules`\n- Any custom `##` headings not matching AIWG patterns\n\n### Step 5: Execute Merge\n\n**CRITICAL**: Call the `setup-warp.mjs` script via Bash tool. This script handles all merge logic.\n\n**Scenario 1: No existing WARP.md**\n\n```bash\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc\n```\n\nScript will:\n- Generate WARP.md from template\n- Aggregate all agents and commands\n- Substitute `{AIWG_ROOT}` with actual path\n- Create WARP.md in project directory\n\n**Scenario 2: WARP.md exists, no AIWG section**\n\n```bash\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc\n```\n\nScript will:\n- Read existing WARP.md\n- Preserve all user content\n- Append AIWG sections with separator\n- Add timestamp marker: `\u003C!-- AIWG SDLC Framework (auto-updated) -->`\n\n**Scenario 3: WARP.md exists with AIWG section**\n\n```bash\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc\n```\n\nScript will:\n- Read existing WARP.md\n- Identify and preserve user sections\n- Replace AIWG sections with updated content\n- Maintain all custom user sections\n\n**Alternative: Dry-run first**\n\n```bash\n# Preview changes without writing\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc \\\n  --dry-run\n```\n\n### Step 6: Validate Setup\n\nRun validation checks:\n\n```bash\necho \"\"\necho \"=======================================================================\"\necho \"Warp Setup Validation\"\necho \"=======================================================================\"\necho \"\"\n\n# Check 1: AIWG installation accessible\nif [ -d \"$AIWG_PATH\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\" ]; then\n  echo \"✓ AIWG installation: $AIWG_PATH\"\nelse\n  echo \"❌ AIWG installation not accessible\"\nfi\n\n# Check 2: WARP.md updated\nif [ -f \"$WARP_MD\" ]; then\n  if grep -q \"## AIWG\" \"$WARP_MD\"; then\n    echo \"✓ WARP.md has AIWG section\"\n  else\n    echo \"❌ WARP.md missing AIWG section\"\n  fi\nelse\n  echo \"❌ WARP.md not found\"\nfi\n\n# Check 3: Agent count\nagent_count=$(grep -c \"^### \" \"$WARP_MD\" || true)\nif [ \"$agent_count\" -ge 58 ]; then\n  echo \"✓ WARP.md contains $agent_count agents (expected: 58+)\"\nelse\n  echo \"⚠️  Warning: WARP.md contains only $agent_count agents (expected: 58+)\"\nfi\n\n# Check 4: Command count\ncommand_count=$(grep -c \"^### \u002F\" \"$WARP_MD\" || true)\nif [ \"$command_count\" -ge 40 ]; then\n  echo \"✓ WARP.md contains $command_count+ commands (expected: 42+)\"\nelse\n  echo \"⚠️  Warning: WARP.md contains only $command_count commands (expected: 42+)\"\nfi\n\n# Check 5: Warp compatibility note\nif grep -q \"Warp Terminal\" \"$WARP_MD\"; then\n  echo \"✓ Warp Terminal compatibility documented\"\nelse\n  echo \"⚠️  Warning: Warp Terminal compatibility not documented\"\nfi\n\necho \"\"\necho \"=======================================================================\"\n```\n\nUse Bash tool for validation.\n\n### Step 7: Provide Next Steps\n\nAfter successful setup, provide clear guidance:\n\n```markdown\n# Warp Setup Complete ✓\n\n**Project**: {project-directory}\n**AIWG Installation**: {AIWG_PATH}\n**WARP.md**: {CREATED | UPDATED | MERGED}\n\n## Changes Made\n\n### WARP.md\n- ✓ Added\u002FUpdated AIWG framework documentation\n- ✓ Aggregated 58 SDLC agents into single file\n- ✓ Aggregated 42+ SDLC commands into single file\n- ✓ Included Core Platform Orchestrator guidance\n- ✓ Added natural language command translations\n- {if existing WARP.md} ✓ Preserved all user content\n\n### User Content Preserved\n- ✓ Project-specific rules\n- ✓ Tech stack preferences\n- ✓ Team conventions\n- ✓ {N} custom sections preserved\n\n## Next Steps\n\n1. **Initialize Warp**:\n   ```bash\n   # Open project in Warp Terminal\n   cd {project-directory}\n\n   # Warp will automatically load WARP.md\n   # Or manually trigger: warp \u002Finit\n   ```\n\n2. **Test Natural Language**:\n   - \"Let's transition to Elaboration\"\n   - \"Run security review\"\n   - \"Where are we?\"\n\n3. **Use Slash Commands**:\n   - Type `\u002F` in Warp input field\n   - Browse available commands\n   - Execute SDLC workflows\n\n4. **Check WARP.md**:\n   - Review aggregated agents and commands\n   - Verify user content preserved\n   - Add project-specific notes if needed\n\n## Warp Terminal Usage\n\n**Warp automatically loads WARP.md** when you:\n- Open terminal in project directory\n- Run `warp \u002Finit` manually\n- Edit files in the project\n\n**Natural language examples**:\n- \"transition to Elaboration\" → Orchestrates phase transition\n- \"run security review\" → Executes security validation\n- \"create architecture baseline\" → Generates SAD + ADRs\n\n## Resources\n\n- **AIWG Framework**: {AIWG_PATH}\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\u002FREADME.md\n- **Warp Documentation**: https:\u002F\u002Fdocs.warp.dev\u002Fknowledge-and-collaboration\u002Frules\n- **Natural Language Guide**: {AIWG_PATH}\u002Fdocs\u002Fsimple-language-translations.md\n- **Orchestrator Docs**: {AIWG_PATH}\u002Fdocs\u002Forchestrator-architecture.md\n- **Multi-Agent Pattern**: {AIWG_PATH}\u002Fdocs\u002Fmulti-agent-documentation-pattern.md\n\n## Troubleshooting\n\n**Setup Script Not Found**:\n```bash\n# Verify AIWG installation\nls {AIWG_PATH}\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\n\n# If missing, reinstall AIWG\naiwg -reinstall\n```\n\n**WARP.md Not Loading in Warp**:\n- Ensure WARP.md is in project root (not subdirectory)\n- Check file permissions: `chmod 644 WARP.md`\n- Restart Warp Terminal\n- Manually trigger: `warp \u002Finit`\n\n**Agent\u002FCommand Count Too Low**:\n- Verify AIWG installation is complete\n- Re-run setup: `\u002Faiwg-setup-warp`\n- Check for errors in setup-warp.mjs output\n\n**Need to Update WARP.md Again**:\n```bash\n# Safe to run multiple times - preserves user content\n\u002Faiwg-setup-warp\n\n# Or use update command explicitly\n\u002Faiwg-update-warp\n```\n```\n\n## Implementation Notes\n\n**Tools to Use**:\n1. **Bash**: Resolve AIWG path, call setup-warp.mjs script, run validation\n2. **Read**: Check existing WARP.md before merge\n3. **Grep**: Detect AIWG section presence, count agents\u002Fcommands\n4. **Script Execution**: Call `setup-warp.mjs` for all merge operations\n\n**Critical Success Factors**:\n- ✅ Preserve ALL user content (never delete existing notes)\n- ✅ Call `setup-warp.mjs` script (don't manually merge)\n- ✅ Substitute `{AIWG_ROOT}` with actual resolved path\n- ✅ Include complete AIWG section (orchestration, agents, commands)\n- ✅ Validate setup before declaring success\n\n**Error Handling**:\n- If AIWG not found → Fail with install instructions\n- If setup-warp.mjs not found → Fail with reinstall instructions\n- If WARP.md unparseable → Script handles with warning\n- If permissions denied → Fail with permission error\n\n## Success Criteria\n\nThis command succeeds when:\n- [ ] AIWG installation path resolved and validated\n- [ ] setup-warp.mjs script executed successfully\n- [ ] WARP.md created or updated with complete AIWG section\n- [ ] All existing user content preserved (if existing WARP.md)\n- [ ] `{AIWG_ROOT}` placeholder replaced with actual path\n- [ ] Agent count ≥ 58\n- [ ] Command count ≥ 42\n- [ ] Validation checks pass\n- [ ] Clear next steps provided to user\n- [ ] Natural language translation guide documented\n\n## Script Parameters\n\nWhen calling `setup-warp.mjs`:\n\n**Required**:\n- `--target \u003Cpath>`: Target project directory\n\n**Optional**:\n- `--mode \u003Ctype>`: Mode: general, sdlc, or both (default: sdlc)\n- `--dry-run`: Preview changes without writing\n- `--force`: Overwrite WARP.md (discard user content) - USE WITH CAUTION\n\n**Examples**:\n\n```bash\n# Standard setup (preserves user content)\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" --target \"$PROJECT_DIR\" --mode sdlc\n\n# Preview without writing\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" --target \"$PROJECT_DIR\" --dry-run\n\n# Force overwrite (DANGEROUS - discards user content)\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" --target \"$PROJECT_DIR\" --force\n```\n\n---\n\n**Command Version**: 1.0\n**Category**: SDLC Setup\n**Mode**: Interactive Setup and Configuration\n**Platform**: Warp Terminal\n\n## References\n\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Faddons\u002Faiwg-utils\u002Frules\u002Fagent-deployment.md — Rules for working with agent definitions and multi-provider deployment\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Faddons\u002Faiwg-utils\u002Frules\u002Fhuman-authorization.md — Seek explicit authorization before overwriting user content in WARP.md\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Faddons\u002Faiwg-utils\u002Frules\u002Fresearch-before-decision.md — Detect AIWG installation and WARP.md state before making changes\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\u002Fskills\u002Faiwg-update-warp\u002FSKILL.md — Companion skill for updating an already-configured Warp project\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\u002Fskills\u002Faiwg-setup-project\u002FSKILL.md — Analogous Claude Code setup skill; shares same merge strategy pattern\n\n","# AIWG Setup Warp\n\nYou are an SDLC Setup Specialist responsible for configuring existing projects to use the AIWG SDLC framework with Warp Terminal.\n\n## Your Task\n\nWhen invoked with `\u002Faiwg-setup-warp [project-directory]`:\n\n1. **Detect** AIWG installation path\n2. **Read** existing project WARP.md (if present)\n3. **Preserve** all user-specific notes, rules, and configuration\n4. **Add or update** AIWG framework section with orchestration guidance\n5. **Aggregate** all SDLC agents and commands into single WARP.md file\n6. **Validate** setup is complete\n\n## Important Context\n\nThis command is designed for **existing projects** that want to adopt the AIWG SDLC framework with Warp Terminal. For **new projects**, use `aiwg -new` instead.\n\n**Key differences**:\n- `aiwg -new`: Creates fresh project scaffold with WARP.md template\n- `aiwg-setup-warp`: Updates existing WARP.md while preserving user content\n\n**Warp vs Claude**:\n- Claude: Separate `.claude\u002Fagents\u002F*.md` files\n- Warp: Single `WARP.md` file with aggregated content\n- Warp loads WARP.md automatically when terminal opens in project directory\n\n## Execution Steps\n\n### Step 1: Resolve AIWG Installation Path\n\nDetect where AIWG is installed using standard resolution:\n\n```bash\n# Priority order:\n# 1. Environment variable: $AIWG_ROOT\n# 2. User install: ~\u002F.local\u002Fshare\u002Fai-writing-guide\n# 3. System install: \u002Fusr\u002Flocal\u002Fshare\u002Fai-writing-guide\n# 4. Git repo (dev): \u003Ccurrent-repo-root>\n```\n\n**Implementation**:\n\n```bash\n# Try environment variable first\nif [ -n \"$AIWG_ROOT\" ] && [ -d \"$AIWG_ROOT\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\" ]; then\n  AIWG_PATH=\"$AIWG_ROOT\"\n# Try standard user install\nelif [ -d \"$HOME\u002F.local\u002Fshare\u002Fai-writing-guide\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\" ]; then\n  AIWG_PATH=\"$HOME\u002F.local\u002Fshare\u002Fai-writing-guide\"\n# Try system install\nelif [ -d \"\u002Fusr\u002Flocal\u002Fshare\u002Fai-writing-guide\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\" ]; then\n  AIWG_PATH=\"\u002Fusr\u002Flocal\u002Fshare\u002Fai-writing-guide\"\n# Fallback: not found\nelse\n  echo \"❌ Error: AIWG installation not found\"\n  echo \"\"\n  echo \"Please install AIWG first:\"\n  echo \"  curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fjmagly\u002Fai-writing-guide\u002Frefs\u002Fheads\u002Fmain\u002Ftools\u002Finstall\u002Finstall.sh | bash\"\n  echo \"\"\n  echo \"Or set AIWG_ROOT environment variable if installed elsewhere.\"\n  exit 1\nfi\n```\n\nUse Bash tool to resolve the path, then store result.\n\n### Step 2: Check Existing WARP.md\n\nDetect if project already has WARP.md and whether it contains AIWG section:\n\n```bash\nPROJECT_DIR=\"${1:-.}\"  # Default to current directory\nWARP_MD=\"$PROJECT_DIR\u002FWARP.md\"\n```\n\n**Three scenarios**:\n\n1. **No WARP.md** → Create from template\n2. **WARP.md exists, no AIWG section** → Intelligently merge\n3. **WARP.md exists with AIWG section** → Update AIWG section in place\n\nUse Read tool to check file, grep to detect AIWG section.\n\n**Key Difference from Claude**: Warp uses single `WARP.md` file, not `.warp\u002Fagents\u002F*.md` subdirectories.\n\n### Step 3: Load AIWG Template\n\nInstead of directly reading a template file, you must **call the setup-warp.mjs script** to generate the aggregated WARP.md content:\n\n```bash\n# Call setup script to generate WARP.md content\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc \\\n  --dry-run\n```\n\n**Script responsibilities**:\n1. Read base AIWG orchestration context\n2. Aggregate all 58 agent files → \"SDLC Agents\" section\n3. Aggregate all 42+ command files → \"SDLC Commands\" section\n4. Combine into single WARP.md template with proper formatting\n\n**Template structure** (generated by script):\n\n```markdown\n# Project Context\n\n\u003C!-- User content preserved above this line -->\n\n---\n\n## AIWG SDLC Framework\n\n{AIWG orchestration overview}\n\n---\n\n## SDLC Agents (58 Specialized Roles)\n\n### Intake Coordinator\n\n**Tools**: Bash, Read, Write, MultiEdit, WebFetch\n\n**Purpose**: Transform intake forms into validated inception plans...\n\n{agent content aggregated from all .md files}\n\n---\n\n## SDLC Commands (42+ Workflows)\n\n### \u002Fintake-wizard\n\n**Purpose**: Generate or complete intake forms interactively\n\n{command content aggregated from all .md files}\n\n---\n```\n\n### Step 4: Intelligent Merge Strategy\n\n**Same pattern as aiwg-setup-project**:\n\n```python\n# Pseudo-code\n# Parse existing WARP.md sections\nsections = parse_markdown_sections(existing_warp_md)\n\n# Identify user sections (NOT AIWG-managed)\nuser_sections = [s for s in sections if not is_aiwg_section(s.heading)]\n\n# Identify AIWG sections (to be replaced)\naiwg_sections = [s for s in sections if is_aiwg_section(s.heading)]\n\n# Merge: user first, then AIWG\nmerged_content = format_sections(user_sections) + \"\\n\\n---\\n\\n\" + aiwg_template\n```\n\n**AIWG-managed section headings**:\n- `## AIWG SDLC Framework`\n- `## SDLC Agents`\n- `## SDLC Commands`\n- `## Platform Compatibility`\n- `## Core Orchestrator`\n- `## Natural Language`\n- `## Phase Overview`\n\n**User-managed sections** (preserved):\n- `# Project Context` (header)\n- `## Tech Stack`\n- `## Team Conventions`\n- `## Project Rules`\n- Any custom `##` headings not matching AIWG patterns\n\n### Step 5: Execute Merge\n\n**CRITICAL**: Call the `setup-warp.mjs` script via Bash tool. This script handles all merge logic.\n\n**Scenario 1: No existing WARP.md**\n\n```bash\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc\n```\n\nScript will:\n- Generate WARP.md from template\n- Aggregate all agents and commands\n- Substitute `{AIWG_ROOT}` with actual path\n- Create WARP.md in project directory\n\n**Scenario 2: WARP.md exists, no AIWG section**\n\n```bash\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc\n```\n\nScript will:\n- Read existing WARP.md\n- Preserve all user content\n- Append AIWG sections with separator\n- Add timestamp marker: `\u003C!-- AIWG SDLC Framework (auto-updated) -->`\n\n**Scenario 3: WARP.md exists with AIWG section**\n\n```bash\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc\n```\n\nScript will:\n- Read existing WARP.md\n- Identify and preserve user sections\n- Replace AIWG sections with updated content\n- Maintain all custom user sections\n\n**Alternative: Dry-run first**\n\n```bash\n# Preview changes without writing\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" \\\n  --target \"$PROJECT_DIR\" \\\n  --mode sdlc \\\n  --dry-run\n```\n\n### Step 6: Validate Setup\n\nRun validation checks:\n\n```bash\necho \"\"\necho \"=======================================================================\"\necho \"Warp Setup Validation\"\necho \"=======================================================================\"\necho \"\"\n\n# Check 1: AIWG installation accessible\nif [ -d \"$AIWG_PATH\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\" ]; then\n  echo \"✓ AIWG installation: $AIWG_PATH\"\nelse\n  echo \"❌ AIWG installation not accessible\"\nfi\n\n# Check 2: WARP.md updated\nif [ -f \"$WARP_MD\" ]; then\n  if grep -q \"## AIWG\" \"$WARP_MD\"; then\n    echo \"✓ WARP.md has AIWG section\"\n  else\n    echo \"❌ WARP.md missing AIWG section\"\n  fi\nelse\n  echo \"❌ WARP.md not found\"\nfi\n\n# Check 3: Agent count\nagent_count=$(grep -c \"^### \" \"$WARP_MD\" || true)\nif [ \"$agent_count\" -ge 58 ]; then\n  echo \"✓ WARP.md contains $agent_count agents (expected: 58+)\"\nelse\n  echo \"⚠️  Warning: WARP.md contains only $agent_count agents (expected: 58+)\"\nfi\n\n# Check 4: Command count\ncommand_count=$(grep -c \"^### \u002F\" \"$WARP_MD\" || true)\nif [ \"$command_count\" -ge 40 ]; then\n  echo \"✓ WARP.md contains $command_count+ commands (expected: 42+)\"\nelse\n  echo \"⚠️  Warning: WARP.md contains only $command_count commands (expected: 42+)\"\nfi\n\n# Check 5: Warp compatibility note\nif grep -q \"Warp Terminal\" \"$WARP_MD\"; then\n  echo \"✓ Warp Terminal compatibility documented\"\nelse\n  echo \"⚠️  Warning: Warp Terminal compatibility not documented\"\nfi\n\necho \"\"\necho \"=======================================================================\"\n```\n\nUse Bash tool for validation.\n\n### Step 7: Provide Next Steps\n\nAfter successful setup, provide clear guidance:\n\n```markdown\n# Warp Setup Complete ✓\n\n**Project**: {project-directory}\n**AIWG Installation**: {AIWG_PATH}\n**WARP.md**: {CREATED | UPDATED | MERGED}\n\n## Changes Made\n\n### WARP.md\n- ✓ Added\u002FUpdated AIWG framework documentation\n- ✓ Aggregated 58 SDLC agents into single file\n- ✓ Aggregated 42+ SDLC commands into single file\n- ✓ Included Core Platform Orchestrator guidance\n- ✓ Added natural language command translations\n- {if existing WARP.md} ✓ Preserved all user content\n\n### User Content Preserved\n- ✓ Project-specific rules\n- ✓ Tech stack preferences\n- ✓ Team conventions\n- ✓ {N} custom sections preserved\n\n## Next Steps\n\n1. **Initialize Warp**:\n   ```bash\n   # Open project in Warp Terminal\n   cd {project-directory}\n\n   # Warp will automatically load WARP.md\n   # Or manually trigger: warp \u002Finit\n   ```\n\n2. **Test Natural Language**:\n   - \"Let's transition to Elaboration\"\n   - \"Run security review\"\n   - \"Where are we?\"\n\n3. **Use Slash Commands**:\n   - Type `\u002F` in Warp input field\n   - Browse available commands\n   - Execute SDLC workflows\n\n4. **Check WARP.md**:\n   - Review aggregated agents and commands\n   - Verify user content preserved\n   - Add project-specific notes if needed\n\n## Warp Terminal Usage\n\n**Warp automatically loads WARP.md** when you:\n- Open terminal in project directory\n- Run `warp \u002Finit` manually\n- Edit files in the project\n\n**Natural language examples**:\n- \"transition to Elaboration\" → Orchestrates phase transition\n- \"run security review\" → Executes security validation\n- \"create architecture baseline\" → Generates SAD + ADRs\n\n## Resources\n\n- **AIWG Framework**: {AIWG_PATH}\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\u002FREADME.md\n- **Warp Documentation**: https:\u002F\u002Fdocs.warp.dev\u002Fknowledge-and-collaboration\u002Frules\n- **Natural Language Guide**: {AIWG_PATH}\u002Fdocs\u002Fsimple-language-translations.md\n- **Orchestrator Docs**: {AIWG_PATH}\u002Fdocs\u002Forchestrator-architecture.md\n- **Multi-Agent Pattern**: {AIWG_PATH}\u002Fdocs\u002Fmulti-agent-documentation-pattern.md\n\n## Troubleshooting\n\n**Setup Script Not Found**:\n```bash\n# Verify AIWG installation\nls {AIWG_PATH}\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\n\n# If missing, reinstall AIWG\naiwg -reinstall\n```\n\n**WARP.md Not Loading in Warp**:\n- Ensure WARP.md is in project root (not subdirectory)\n- Check file permissions: `chmod 644 WARP.md`\n- Restart Warp Terminal\n- Manually trigger: `warp \u002Finit`\n\n**Agent\u002FCommand Count Too Low**:\n- Verify AIWG installation is complete\n- Re-run setup: `\u002Faiwg-setup-warp`\n- Check for errors in setup-warp.mjs output\n\n**Need to Update WARP.md Again**:\n```bash\n# Safe to run multiple times - preserves user content\n\u002Faiwg-setup-warp\n\n# Or use update command explicitly\n\u002Faiwg-update-warp\n```\n```\n\n## Implementation Notes\n\n**Tools to Use**:\n1. **Bash**: Resolve AIWG path, call setup-warp.mjs script, run validation\n2. **Read**: Check existing WARP.md before merge\n3. **Grep**: Detect AIWG section presence, count agents\u002Fcommands\n4. **Script Execution**: Call `setup-warp.mjs` for all merge operations\n\n**Critical Success Factors**:\n- ✅ Preserve ALL user content (never delete existing notes)\n- ✅ Call `setup-warp.mjs` script (don't manually merge)\n- ✅ Substitute `{AIWG_ROOT}` with actual resolved path\n- ✅ Include complete AIWG section (orchestration, agents, commands)\n- ✅ Validate setup before declaring success\n\n**Error Handling**:\n- If AIWG not found → Fail with install instructions\n- If setup-warp.mjs not found → Fail with reinstall instructions\n- If WARP.md unparseable → Script handles with warning\n- If permissions denied → Fail with permission error\n\n## Success Criteria\n\nThis command succeeds when:\n- [ ] AIWG installation path resolved and validated\n- [ ] setup-warp.mjs script executed successfully\n- [ ] WARP.md created or updated with complete AIWG section\n- [ ] All existing user content preserved (if existing WARP.md)\n- [ ] `{AIWG_ROOT}` placeholder replaced with actual path\n- [ ] Agent count ≥ 58\n- [ ] Command count ≥ 42\n- [ ] Validation checks pass\n- [ ] Clear next steps provided to user\n- [ ] Natural language translation guide documented\n\n## Script Parameters\n\nWhen calling `setup-warp.mjs`:\n\n**Required**:\n- `--target \u003Cpath>`: Target project directory\n\n**Optional**:\n- `--mode \u003Ctype>`: Mode: general, sdlc, or both (default: sdlc)\n- `--dry-run`: Preview changes without writing\n- `--force`: Overwrite WARP.md (discard user content) - USE WITH CAUTION\n\n**Examples**:\n\n```bash\n# Standard setup (preserves user content)\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" --target \"$PROJECT_DIR\" --mode sdlc\n\n# Preview without writing\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" --target \"$PROJECT_DIR\" --dry-run\n\n# Force overwrite (DANGEROUS - discards user content)\nnode \"$AIWG_PATH\u002Ftools\u002Fwarp\u002Fsetup-warp.mjs\" --target \"$PROJECT_DIR\" --force\n```\n\n---\n\n**Command Version**: 1.0\n**Category**: SDLC Setup\n**Mode**: Interactive Setup and Configuration\n**Platform**: Warp Terminal\n\n## References\n\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Faddons\u002Faiwg-utils\u002Frules\u002Fagent-deployment.md — Rules for working with agent definitions and multi-provider deployment\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Faddons\u002Faiwg-utils\u002Frules\u002Fhuman-authorization.md — Seek explicit authorization before overwriting user content in WARP.md\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Faddons\u002Faiwg-utils\u002Frules\u002Fresearch-before-decision.md — Detect AIWG installation and WARP.md state before making changes\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\u002Fskills\u002Faiwg-update-warp\u002FSKILL.md — Companion skill for updating an already-configured Warp project\n- @$AIWG_ROOT\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsdlc-complete\u002Fskills\u002Faiwg-setup-project\u002FSKILL.md — Analogous Claude Code setup skill; shares same merge strategy pattern\n\n",{"name":5,"namespace":50,"platforms":51,"commandHint":53,"description":7},"aiwg",[52],"all",{"model":39,"category":54,"modelRole":31,"modelTier":55,"allowedTools":56,"argumentHint":57},"sdlc-setup","economy","Read, Write, Edit, Glob, Bash",[58],"project-directory --interactive --guidance \"text\"","main","6754967c344ccb087a8de06972f55a41067b291b","agentic\u002Fcode\u002Fplugins\u002Fcodex-sdlc\u002Fskills\u002Faiwg-setup-warp",36,"https:\u002F\u002Fgithub.com\u002Fjmagly\u002Faiwg","https:\u002F\u002Faiwg.io","https:\u002F\u002Fgithub.com\u002Fjmagly","https:\u002F\u002Fintegrolabs.io","ml\u002Fai, industrial automation, safety\u002Fsecurity, ssi\r\n\r\nmagly.net\r\nintegrolabs.io\r\naiwg.io\r\nfortemi.com\r\npagenary.com\r\nbytecask.com","2026-11-12 21:57:33",{"source":8,"skillName":5,"commands":70,"prompt":80,"zipAvailable":81},[71,74,77],{"tool":72,"command":73},"npx","npx skills add jmagly\u002Faiwg --skill aiwg-setup-warp",{"tool":75,"command":76},"bunx","bunx skills add jmagly\u002Faiwg --skill aiwg-setup-warp",{"tool":78,"command":79},"pnpm","pnpm dlx skills add jmagly\u002Faiwg --skill aiwg-setup-warp","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjmagly\u002Faiwg\u002Fblob\u002Fmain\u002Fagentic\u002Fcode\u002Fplugins\u002Fcodex-sdlc\u002Fskills\u002Faiwg-setup-warp\u002FSKILL.md",true,[],[84,110,133,139,146,160],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":91,"publishedAt":45},"01M70QA0BSYJ49EES9V4RE8QH1","host-hardening","Read-only system hardening baseline and plan-first host hardening recommendations for SSH, Docker bind addresses, firewall persistence, datastores, exporters and audit retention.","https:\u002F\u002Fgithub.com\u002Fjmagly\u002Faiwg\u002Fblob\u002Fmain\u002Fagentic\u002Fcode\u002Fplugins\u002Fsecurity-engineering\u002Fskills\u002Fhost-hardening\u002FSKILL.md",[90],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[92,93,94,38,95,96,97,98,99,100,41,101,102,103,104,105,106,107,108,109],"host","host hardening","hardening","re","recommendations","remediation","plan","port","verification","access","only","retention","audit","never","firewall","bind","secrets","request",{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":120,"publishedAt":45},"01M70PNT2Z4HMZPRBTAF6073NN","exposure-analysis","Read-only firewall analysis and effective host exposure reconstruction for Docker published ports, UFW bypass, stale rules, CDN scope, IPv6 asymmetry and external probe allowlists.","https:\u002F\u002Fgithub.com\u002Fjmagly\u002Faiwg\u002Fblob\u002Fmain\u002Fagentic\u002Fcode\u002Fplugins\u002Fforensics\u002Fskills\u002Fexposure-analysis\u002FSKILL.md",[116,119],{"categoryNo":117,"categoryName":118,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000011","运维与部署",{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[121,122,123,38,124,99,125,126,41,127,92,128,102,129,130,105,106,131,132,27],"exposure analysis","analysis","unknown","credentials","collection","ufw","ports","internet","local","scope","reconstruction","operator",{"skillNo":134,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":135,"categories":136,"keywords":138,"publishedAt":45},"01M70P8QATMPKA78E4FT5D2TNA","https:\u002F\u002Fgithub.com\u002Fjmagly\u002Faiwg\u002Fblob\u002Fmain\u002Fagentic\u002Fcode\u002Fframeworks\u002Fsecurity-engineering\u002Fskills\u002Fhost-hardening\u002FSKILL.md",[137],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[94,92,93,101,38,109,97,96,104,98,99,100,41,108,102,103,95,105,106,107],{"skillNo":140,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":141,"categories":142,"keywords":145,"publishedAt":45},"01M70NMPVJ5H0JH131P60FW4R8","https:\u002F\u002Fgithub.com\u002Fjmagly\u002Faiwg\u002Fblob\u002Fmain\u002Fagentic\u002Fcode\u002Fframeworks\u002Fforensics-complete\u002Fskills\u002Fexposure-analysis\u002FSKILL.md",[143,144],{"categoryNo":117,"categoryName":118,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[122,121,105,124,99,125,41,123,92,128,102,129,130,38,106,127,126,131,132,27],{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":150,"categories":151,"keywords":153,"publishedAt":45},"01M6CB4DDR0B4NNCFK7ZK7449H","fixture-skill","Exercise rule delivery.","https:\u002F\u002Fgithub.com\u002Fjmagly\u002Faiwg\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Frule-delivery\u002Fskills\u002Ffixture-skill\u002FSKILL.md",[152],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[154,155,156,157,158,159],"fixture skill","fixture","rule","delivery","true","exercise",{"skillNo":161,"name":162,"nameZh":6,"description":163,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":164,"categories":165,"keywords":167,"publishedAt":45},"01M6CB4AVK1W76MFMPP0JP32CJ","pi-local","Pi-local duplicate-precedence fixture.","https:\u002F\u002Fgithub.com\u002Fjmagly\u002Faiwg\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fproviders\u002Fpi\u002Fproject\u002F.pi\u002Fskills\u002Fpi-local\u002FSKILL.md",[166],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[168,169,129,170,155],"pi","pi local","duplicate"]