NoizuPromptLingo: Command for Claude Code

Initialize Project (Fast)

Bootstrap project documentation with progressive artifact generation and interstitial working files.

Outputs: CLAUDE.md, docs/PROJECT-ARCH.md, docs/PROJECT-LAYOUT.md

Design Philosophy

no-coordinator : Launch scouts directly — no pre-scan, no orchestration overhead

progressive : Generate drafts as scouts report, refine incrementally

interstitial : Working files in .npl/project-init/ visible during execution, cleaned up at end

minimal-viable : Skeleton docs that can be expanded via /update-arch and /update-layout

---

Phase 1: Initialize Environment

Initialize CLAUDE.md and prepare interstitial workspace:

• Use the NPLLoad MCP tool to load minimal NPL dependencies: NPLLoad(expression="syntax fences directives")
• Use directory exploration tools (Glob, Bash tree) for directory structure exploration

Create interstitial workspace: mkdir -p .npl/project-init/synthesis

Version Handling

The init-claude command uses versioned prompt sections with npl-instructions: YAML headers. Behavior depends on existing CLAUDE.md state:

First-time initialization (no versioned sections):

• Appends all default prompts automatically
• Exit code 1 (changes made)

Existing versioned sections:

• Prints version comparison table (source vs installed)
• Exits without modifying (exit code 2 if updates available, 0 if current)
• User must explicitly choose to update

Write coordination state:

// .npl/project-init/meta.json
{
  "session_start": "<timestamp>",
  "scouts_launched": [],
  "scouts_complete": [],
  "stack_detected": null,
  "synthesis_started": false
}

CLAUDE.md receives:

• NPL Conventions (visualization preferences, tools)
• NPL Load Directive
• NPL Scripts reference
• SQLite Quick Guide

---

Phase 2: Direct Scout Deployment

🎯 Launch all 4 scouts in a single parallel batch. No coordinator, no pre-scan.

Scout Consolidation

Scout	Merged From	Domain	Key Targets
Scout-Foundation	Structure + Layers	Project skeleton, tech stack, layer boundaries	tree, manifests, entry points, config
Scout-Core	Domain + Patterns	Business logic, code patterns, testing	src/, lib/, domain code, tests
Scout-Infra	Services + DevOps	Infrastructure, deployment, external services	docker, k8s, ci/cd, database
Scout-Surface	API	Public interfaces, contracts, documentation	routes, openapi, README