QA: validate ctxo init rule generation across all 7 AI platforms #37

Summary

Manually validate that ctxo init generates correct, working MCP usage rules for each supported AI coding assistant. Rules must be in the correct file, correct format, and actually picked up by the target tool.

Test Environment

npx ctxo-mcp init          # interactive
npx ctxo-mcp init --dry-run # preview

Platform Checklists

Claude Code (CLAUDE.md — append mode)

• Rule section appended with <!-- ctxo-rules-start --> / <!-- ctxo-rules-end --> markers
• Existing CLAUDE.md content preserved (not overwritten)
• Re-running ctxo init replaces section (idempotent, no duplication)
• Claude Code reads and follows the MCP tool usage rules in conversation
• Rules include all 14 tool names (get_blast_radius, get_why_context, etc.)

Cursor (.cursor/rules/ctxo-mcp.mdc — create mode)

• File created at .cursor/rules/ctxo-mcp.mdc
• YAML frontmatter present: alwaysApply: true
• Parent directory .cursor/rules/ auto-created if missing
• Cursor loads the rule file and shows it in rules panel
• Rules applied in Cursor chat/compose sessions

GitHub Copilot (.github/copilot-instructions.md — create mode)

• File created at .github/copilot-instructions.md
• Plain markdown format (no frontmatter)
• Parent directory .github/ auto-created if missing
• Copilot Chat picks up instructions in VS Code agent mode
• Rules influence Copilot's tool selection behavior

Windsurf (.windsurfrules — create mode)

• File created at project root as .windsurfrules
• Plain markdown format (no frontmatter)
• Windsurf Cascade reads and applies rules
• Rules visible in Windsurf rules panel

Google Antigravity (AGENTS.md — create mode)

• File created at project root as AGENTS.md
• Plain markdown format
• Antigravity agent reads AGENTS.md at session start
• Rules applied during code modification tasks

Augment Code (augment-guidelines.md — create mode)

• File created at project root as augment-guidelines.md
• Plain markdown format
• Augment Code extension reads guidelines file
• Rules influence Augment's suggestions

Amazon Q (.amazonq/rules/ctxo-mcp.md — create mode)

• File created at .amazonq/rules/ctxo-mcp.md
• Parent directory .amazonq/rules/ auto-created if missing
• Amazon Q Developer reads rules in agent mode
• Rules influence Q's tool usage behavior

Cross-Platform Checks

Auto-Detection

• Claude Code detected when CLAUDE.md or .claude/ exists
• Cursor detected when .cursor/ or .cursorrules exists
• Copilot detected when .github/ or .vscode/ exists
• Windsurf detected when .windsurfrules or .windsurf/ exists
• Antigravity detected when AGENTS.md, GEMINI.md, or .gemini/ exists
• Augment detected when augment-guidelines.md or .augment/ exists
• Amazon Q detected when .amazonq/ exists
• Detected tools shown as pre-selected with green "(detected)" label

Scaffolding

• .gitignore entry for .ctxo/.cache/ added (or skipped if present)
• .ctxo/config.yaml created with defaults (or skipped if present)
• .ctxo/index/ directory created

Non-Interactive Mode

• ctxo init --tools claude-code,cursor -y works without prompts
• ctxo init --rules regenerates rules without touching hooks or index dir
• ctxo init --dry-run shows preview without creating files
• Unknown tool ID prints error with valid options list

Idempotency

• Running ctxo init twice does not duplicate rules in any file
• CLAUDE.md section markers prevent duplication (append mode)
• Create-mode files overwritten cleanly on re-run
• Git hooks not duplicated on re-run