tachi: Command for Claude Code

User Input

$ARGUMENTS

Consider user input before proceeding (if not empty).

Overview

Generates a structured architecture description suitable as input for /tachi.threat-model. Analyzes the target codebase or project documentation to produce a DFD-style architecture description with components, data flows, trust boundaries, and external entities.

Output: architecture.md — structured architecture description in the target directory.

Step 0: Detect Existing File

1. After determining the output path (Step 1), check if an architecture file already exists at that path
2. If the file exists:
   • Read the file contents
   • Check for YAML frontmatter (content between opening --- and closing --- delimiters at the start of the file)
   • If frontmatter exists, parse these fields:
     • version — integer version number
     • date — generation date (YYYY-MM-DD)
     • description — change summary
     • checksum — sha256:{hash} of the content body
     • previous_version — archive path or null
   • If no frontmatter is found: treat as a legacy file with version 0
3. If no file exists at the output path: this is a fresh generation (version will be 1)
4. Store the detected state (file exists, current version, has frontmatter) for use by Step 0a and Step 3a

Step 0a: Archive Current Version

1. Skip this step entirely if no existing file was detected (first-time generation)
2. Derive the archive path: {parent_dir}/.archive/v{N}/{filename} where:
   • {parent_dir} = directory containing the architecture file
   • {N} = current version number (0 for legacy files without frontmatter, extracted version for managed files)
   • {filename} = architecture filename (default: architecture.md)
3. Create the archive directory: mkdir -p {parent_dir}/.archive/v{N}/
4. Copy the complete file (including frontmatter, if present) to the archive location
5. If the same version already exists in the archive, overwrite it (idempotent retry — supports re-runs after failed generations)
6. Display:

   Archived v{N} to {archive_path}