architecting-act

# Architecting {{ cookiecutter.act_name }} Act Design and manage Act (project) and Cast (graph) architectures through dynamic, context-aware questioning. Outputs `CLAUDE.md` at project root containing Act overview and all Cast specifications. ## When to Use - Planning initial Act architecture (after `act new`) - Adding new Cast to existing Act - Analyzing Cast complexity for Sub-Cast extraction - Redesigning existing Cast architecture (already implemented code exists) - Unclear about architecture design ## When NOT to Use - Implementing LangGraph cast code → use `developing-cast` - Implementing DeepAgent agent code → use `developing-deepagent` - Scaffolding cast directories → run `uv run act cast -c "<Cast Name>"` directly - Writing tests → use `testing-cast` --- ## Core Principles **DYNAMIC QUESTIONING**: - First analyze context (user request, CLAUDE.md, existing files) - Use AskUserQuestion tool for structured option selection - Skip questions when answer is inferable from context - Group related questions when appropriate (up to 4 at once) **NO CODE**: Describe structures only. No TypedDict, functions, or implementation code. **DIAGRAMS SHOW EDGES**: Mermaid diagram contains all nodes and edges. No separate tables. --- ## Mode Detection **First, determine which mode:** - **CLAUDE.md doesn't exist?** → **Mode 1: Initial Design** - **CLAUDE.md exists + adding cast?** → **Mode 2: Add Cast** - **CLAUDE.md exists + cast complex?** → **Mode 3: Extract Sub-Cast** - ...