aiwg-regenerate-warp

Regenerate WARP.md

Regenerate the WARP.md file for Warp Terminal integration, analyzing current project state while preserving team directives and organizational requirements.

Hook file approach (default): Generates AIWG-warp.md and adds a section or @AIWG-warp.md directive to WARP.md. Note: Warp's @-link support is unverified — defaults to section-style toggle until confirmed (see #444).

Full inject (--full-inject): Embeds AIWG content inline in WARP.md with AIWG markers.

Parameters

Flag	Description
--no-backup	Skip creating backup file
--dry-run	Preview changes without writing
--show-preserved	List all detected preserved content and exit
--full	Full regeneration, preserve nothing (destructive)

Warp Terminal Conventions

WARP.md follows Warp Terminal formatting conventions:

• ### headings for agents and commands (not ##)
• Inline tool lists with agents
• Terminal-friendly command formatting (easy copy-paste)
• Concise descriptions optimized for terminal display

Execution Steps

Step 1: Create Backup

Unless --no-backup specified:

1. Check if WARP.md exists
2. If exists, copy to WARP.md.backup-{YYYYMMDD-HHMMSS}
3. Report backup location

Step 2: Extract Preserved Content

Same preservation patterns as CLAUDE.md:

1. Explicit Preserve Blocks: <!-- PRESERVE --> ... <!-- /PRESERVE -->
2. Preserved Section Headings: Team *, Org *, Definition of Done, etc.
3. Inline Directives: Lines with directive keywords

Step 3: Analyze Project

Same project analysis as CLAUDE.md:

• Languages and package managers
• Development commands
• Test framework
• CI/CD configuration
• Directory structure

Step 4: Detect AIWG State

Check installed frameworks and deployed assets:

• Scan for WARP-specific formatting in existing files
• Count agents and commands
• Identify active frameworks

Step 5: Generate WARP.md

Document Structure (Warp Format):

# WARP.md

Project guidance for Warp Terminal AI assistance.

## Project Overview

{Brief project description from README.md}

**Tech Stack**: {languages} | **Package Manager**: {npm/pip/etc} | **Test Framework**: {framework}

## Quick Commands

Copy-paste ready commands for common tasks:

```bash