@fifine/aim-studio 0.0.2 → 0.0.3

package/dist/templates/claude/commands/aim/onboard.md

@@ -41,7 +41,7 @@ Every AI session starts with a blank slate. Unlike human engineers who accumulat
 
 **The Problem**: Without memory, AI asks the same questions repeatedly, makes the same mistakes, and can't build on previous work.
 
-**The Solution**: The `.aim-studio/workspace/` system captures what happened in each session - what was done, what was learned, what problems were solved. The `/aim:start` command reads this history at session start, giving AI "artificial memory."
+**The Solution**: The `aim-workspace/` system captures what happened in each session - what was done, what was learned, what problems were solved. The `/aim:start` command reads this history at session start, giving AI "artificial memory."
 
 ### Challenge 2: AI Has Generic Knowledge, Not Project-Specific Knowledge
 
@@ -67,11 +67,13 @@ Even after injecting guidelines, AI has limited context window. As conversation
 .aim-studio/
 |-- .developer              # Your identity (gitignored)
 |-- workflow.md             # Complete workflow documentation
-|-- workspace/              # "AI Memory" - session history
-|   |-- index.md            # All developers' progress
-|   +-- {developer}/        # Per-developer directory
-|       |-- index.md        # Personal progress index
-|       +-- journal-N.md    # Session records (max 2000 lines)
+|-- tasks/                  # Task tracking (unified)
+
+aim-workspace/               # "AI Memory" - session history (directly visible)
+|-- index.md                # All developers' progress
++-- {developer}/            # Per-developer directory
+    |-- index.md            # Personal progress index
+    +-- journal-N.md        # Session records (max 2000 lines)
 |-- tasks/                  # Task tracking (unified)
 |   +-- {MM}-{DD}-{slug}/   # Task directory
 |       |-- task.json       # Task metadata
@@ -116,7 +118,7 @@ AI needs the same onboarding - but compressed into seconds at session start.
 **WHAT IT ACTUALLY DOES**:
 1. Reads developer identity (who am I in this project?)
 2. Checks git status (what branch? uncommitted changes?)
-3. Reads recent session history from `workspace/` (what happened before?)
+3. Reads recent session history from `aim-workspace/` (what happened before?)
 4. Identifies active features (what's in progress?)
 5. Understands current project state before making any changes
 
@@ -199,7 +201,7 @@ The `/check-*` commands focus on code quality within a single layer. But real ch
 All the context AI built during this session will be lost when session ends. The next session's `/aim:start` needs this information.
 
 **WHAT IT ACTUALLY DOES**:
-1. Records session summary to `workspace/{developer}/journal-N.md`
+1. Records session summary to `aim-workspace/{developer}/journal-N.md`
 2. Captures what was done, learned, and what's remaining
 3. Updates index files for quick lookup
 

package/dist/templates/claude/commands/aim/start.md

@@ -1,25 +1,25 @@
 ---
 name: start
-description: 开始 AIM Studio 创作会话
+description: 开始 AIM Studio 开发会话
 ---
 
 # 开始会话
 
-初始化 AIM Studio 漫剧创作会话，开始你的创作之旅。
+初始化 AIM Studio 开发会话，开始你的开发工作。
 
 ---
 
 ## 适用场景
 
-- 首次开始漫剧创作
-- 开始新的创作会话
+- 首次开始项目开发
+- 开始新的开发会话
 - 想要了解当前项目状态
 
 ---
 
 ## 使用步骤
 
-### 步骤 1：理解创作工作流
+### 步骤 1：理解工作流
 
 首先阅读工作流指南：
 
@@ -30,28 +30,74 @@ cat .aim-studio/workflow.md
 **遵循 workflow.md 中的指导**，包含：
 - 核心原则（先读后写、遵循规范等）
 - 文件系统结构
-- 创作流程
+- 开发流程
 - 最佳实践
 
 ### 步骤 2：获取当前上下文
 
 ```bash
-aim status
+python3 .aim-studio/scripts/get_context.py
+```
+
+或者查看项目状态：
+
+```bash
+python3 .aim-studio/scripts/task.py status
 ```
 
 显示：项目状态、当前任务（如有）、活跃任务列表。
 
-### 步骤 3：阅读创作规范
+### 步骤 3：阅读开发规范
+
+根据项目类型，阅读相应的规范：
 
+**如果是 CLI 项目**：
 ```bash
-cat .aim-studio/spec/story/script.md     # 剧本与分镜规范
-cat .aim-studio/spec/story/character.md  # 角色设定规范
-cat .aim-studio/spec/story/world.md      # 世界观设定规范
+cat .aim-studio/spec/cli/index.md           # CLI 开发规范
+cat .aim-studio/spec/cli/directory-structure.md
 ```
 
-### 步骤 4：开始创作
+**如果是前端项目**：
+```bash
+cat .aim-studio/spec/frontend/index.md     # 前端开发规范
+cat .aim-studio/spec/frontend/component-guidelines.md
+```
 
-报告你了解到的内容，询问用户："您想要创作什么内容？"
+**如果是后端项目**：
+```bash
+cat .aim-studio/spec/backend/index.md      # 后端开发规范
+cat .aim-studio/spec/backend/directory-structure.md
+```
+
+**如果是全栈项目**：
+```bash
+cat .aim-studio/spec/frontend/index.md
+cat .aim-studio/spec/backend/index.md
+```
+
+**如果是漫剧创作项目**：
+```bash
+cat .aim-studio/spec/story/script.md       # 剧本与分镜规范
+cat .aim-studio/spec/story/character.md    # 角色设定规范
+cat .aim-studio/spec/story/world.md        # 世界观设定规范
+```
+
+### 步骤 4：检查当前任务
+
+查看是否有待完成的任务：
+
+```bash
+python3 .aim-studio/scripts/task.py list
+```
+
+如果有任务，查看任务详情：
+```bash
+python3 .aim-studio/scripts/task.py show <任务名>
+```
+
+### 步骤 5：开始工作
+
+报告你了解到的内容，询问用户："您好！请问今天需要做什么？"
 
 ---
 
@@ -61,31 +107,46 @@ cat .aim-studio/spec/story/world.md      # 世界观设定规范
 
 | 类型 | 标准 | 处理方式 |
 |------|------|----------|
-| 问题 | 用户询问关于创作、角色、世界观的问题 | 直接回答 |
-| 简单修改 | 修改角色设定、世界观设定等 | 直接编辑 |
-| 创作任务 | 创作新剧集、场次、角色等 | 使用 `/aim:story` 创作工作流 |
+| 问题 | 用户询问关于项目的问题 | 直接回答 |
+| 简单修改 | 小改动 | 直接处理 |
+| 开发任务 | 需要多步骤完成的任务 | 创建任务并执行 |
+| 漫剧创作 | 创作新故事、角色等（仅限 story 项目） | 使用 `/aim:story` |
+
+---
+
+## 项目类型检测
+
+根据项目结构自动识别项目类型：
+
+| 项目类型 | 特征 | 规范目录 |
+|----------|------|----------|
+| CLI 工具 | 有 `bin/` 目录 | `spec/cli/` |
+| 前端 | 有 `package.json`、前端框架 | `spec/frontend/` |
+| 后端 | 有 `requirements.txt`、`go.mod` 等 | `spec/backend/` |
+| 全栈 | 既有前端又有后端 | `spec/frontend/` + `spec/backend/` |
+| 漫剧创作 | 有 `spec/story/` | `spec/story/` |
 
 ---
 
 ## 组合使用方案
 
-### 方案一：全新项目启动
+### 方案一：日常开发
 
 ```
 1. /aim:start              → 阅读工作流和项目状态
-2. /aim:story              → 开始创作新项目
-3. /aim:portrait <角色名>  → 生成角色肖像
-4. /aim:visualize          → 生成图片提示词
-5. /aim:finish-work        → 完成工作
+2. 讨论需求...
+3. /aim:finish-work        → 完成工作并记录
 ```
 
-### 方案二：继续现有创作
+### 方案二：漫剧创作（仅限 story 项目）
 
 ```
-1. /aim:start              → 查看当前进度
-2. /aim:check-story        → 检查剧情一致性
-3. 继续创作...
-4. /aim:finish-work        → 完成工作
+1. /aim:start              → 了解项目状态
+2. /aim:story              → 开始创作
+3. /aim:portrait <角色名>  → 创建角色肖像
+4. /aim:visualize          → 生成图片提示词
+5. /aim:check-story        → 检查剧情一致性
+6. /aim:finish-work         → 完成工作并记录
 ```
 
 ---
@@ -94,19 +155,25 @@ cat .aim-studio/spec/story/world.md      # 世界观设定规范
 
 > **规范是注入的，不是记忆的。**
 >
-> 创作工作流确保 AI 接收相关规范。这比希望 AI "记住"规范更可靠。
+> 开发工作流确保 AI 接收相关规范。这比希望 AI "记住"规范更可靠。
 
-> **Seedance 2.0 六要素必须完整。**
->
-> 每个场次文件必须包含：
-> 【主体描述】+【动作/表演】+【环境/氛围】+【镜头语言】+【音频设计】+【风格影调】
+---
+
+## 相关命令（根据项目类型使用）
+
+| 命令 | 用途 | 适用项目 |
+|------|------|----------|
+| `/aim:start` | 开始会话 | 所有 |
+| `/aim:story` | 漫剧创作模式 | story |
+| `/aim:portrait` | 生成角色肖像 | story |
+| `/aim:visualize` | 生成图片提示词 | story |
+| `/aim:check-story` | 检查剧情一致性 | story |
+| `/aim:finish-work` | 完成工作并生成日志 | 所有 |
 
 ---
 
-## 相关命令
+## 注意事项
 
-| 命令 | 用途 |
-|------|------|
-| `/aim:story` | 漫剧创作模式 |
-| `/aim:check-story` | 剧情逻辑检查 |
-| `/aim:finish-work` | 完成工作并生成日志 |
+1. **漫剧命令仅限 story 项目**：如果项目不是漫剧创作类型，`/aim:story` 等命令不可用
+2. **遵循项目规范**：开发前务必阅读 `spec/` 目录下的规范文件
+3. **记录工作进度**：完成工作后使用 `/aim:finish-work` 记录

package/dist/templates/claude/hooks/inject-subagent-context.py

@@ -45,7 +45,7 @@ if sys.platform == "win32":
 # =============================================================================
 
 DIR_WORKFLOW = ".aim-studio"
-DIR_WORKSPACE = "workspace"
+DIR_WORKSPACE = "aim-workspace"
 DIR_TASKS = "tasks"
 DIR_SPEC = "spec"
 FILE_CURRENT_TASK = ".current-task"
@@ -337,10 +337,8 @@ def get_check_context(repo_root: str, task_dir: str) -> str:
     else:
         # Fallback: use hardcoded check files + spec.jsonl
         check_files = [
-            (".claude/commands/trellis/finish-work.md", "Finish work checklist"),
-            (".claude/commands/trellis/check-cross-layer.md", "Cross-layer check spec"),
-            (".claude/commands/trellis/check-backend.md", "Backend check spec"),
-            (".claude/commands/trellis/check-frontend.md", "Frontend check spec"),
+            (".claude/commands/aim/finish-work.md", "Finish work checklist"),
+            (".claude/commands/aim/check-story.md", "Story check spec"),
         ]
         for file_path, description in check_files:
             content = read_file_content(repo_root, file_path)
@@ -382,11 +380,11 @@ def get_finish_context(repo_root: str, task_dir: str) -> str:
     else:
         # Fallback: only finish-work.md (lightweight)
         finish_work = read_file_content(
-            repo_root, ".claude/commands/trellis/finish-work.md"
+            repo_root, ".claude/commands/aim/finish-work.md"
         )
         if finish_work:
             context_parts.append(
-                f"=== .claude/commands/trellis/finish-work.md (Finish checklist) ===\n{finish_work}"
+                f"=== .claude/commands/aim/finish-work.md (Finish checklist) ===\n{finish_work}"
             )
 
     # 2. Requirements document (for verifying requirements are met)
@@ -422,9 +420,7 @@ def get_debug_context(repo_root: str, task_dir: str) -> str:
             context_parts.append(f"=== {file_path} (Dev spec) ===\n{content}")
 
         check_files = [
-            (".claude/commands/trellis/check-backend.md", "Backend check spec"),
-            (".claude/commands/trellis/check-frontend.md", "Frontend check spec"),
-            (".claude/commands/trellis/check-cross-layer.md", "Cross-layer check spec"),
+            (".claude/commands/aim/check-story.md", "Story check spec"),
         ]
         for file_path, description in check_files:
             content = read_file_content(repo_root, file_path)

package/dist/templates/claude/hooks/session-start.py

@@ -65,6 +65,49 @@ def run_script(script_path: Path) -> str:
         return "No context available"
 
 
+def detect_project_type(project_dir: Path) -> str:
+    """Detect project type based on directory structure."""
+
+    # Check for bin/ directory (CLI tool)
+    if (project_dir / "bin").is_dir():
+        return "cli"
+
+    # Check for story project (has spec/story/)
+    if (project_dir / ".aim-studio" / "spec" / "story").is_dir():
+        return "story"
+
+    # Check for frontend indicators
+    frontend_indicators = [
+        "package.json",
+        "vite.config.ts",
+        "vite.config.js",
+        "next.config.js",
+        "next.config.ts",
+        "nuxt.config.ts",
+    ]
+    has_frontend = any((project_dir / f).exists() for f in frontend_indicators)
+
+    # Check for backend indicators
+    backend_indicators = [
+        "requirements.txt",
+        "pyproject.toml",
+        "go.mod",
+        "Cargo.toml",
+        "pom.xml",
+        "composer.json",
+    ]
+    has_backend = any((project_dir / f).exists() for f in backend_indicators)
+
+    if has_frontend and has_backend:
+        return "fullstack"
+    elif has_frontend:
+        return "frontend"
+    elif has_backend:
+        return "backend"
+
+    return "unknown"
+
+
 def main():
     if should_skip_injection():
         sys.exit(0)
@@ -73,58 +116,125 @@ def main():
     trellis_dir = project_dir / ".aim-studio"
     claude_dir = project_dir / ".claude"
 
+    # Detect project type
+    project_type = detect_project_type(project_dir)
+
     output = StringIO()
 
-    output.write("""<session-context>
-You are starting a new session in a Trellis-managed project.
-Read and follow all instructions below carefully.
-</session-context>
+    # 根据项目类型显示不同的欢迎信息
+    welcome_messages = {
+        "cli": "AIM Studio CLI 项目",
+        "frontend": "AIM Studio 前端项目",
+        "backend": "AIM Studio 后端项目",
+        "fullstack": "AIM Studio 全栈项目",
+        "story": "AIM Studio 漫剧创作项目",
+        "unknown": "AIM Studio 项目",
+    }
+
+    output.write(f"""<session-context>
+您正在启动一个 {welcome_messages.get(project_type, 'AIM Studio')} 会话。
+请仔细阅读以下说明并遵循执行。
+
+项目类型: {project_type}
 
 """)
 
+    # Get current context
     output.write("<current-state>\n")
     context_script = trellis_dir / "scripts" / "get_context.py"
     output.write(run_script(context_script))
     output.write("\n</current-state>\n\n")
 
+    # Workflow
     output.write("<workflow>\n")
-    workflow_content = read_file(trellis_dir / "workflow.md", "No workflow.md found")
+    workflow_content = read_file(trellis_dir / "workflow.md", "未找到 workflow.md")
     output.write(workflow_content)
     output.write("\n</workflow>\n\n")
 
+    # Guidelines - 根据项目类型注入相应的规范
     output.write("<guidelines>\n")
 
-    output.write("## Frontend\n")
-    frontend_index = read_file(
-        trellis_dir / "spec" / "frontend" / "index.md", "Not configured"
-    )
-    output.write(frontend_index)
-    output.write("\n\n")
-
-    output.write("## Backend\n")
-    backend_index = read_file(
-        trellis_dir / "spec" / "backend" / "index.md", "Not configured"
-    )
-    output.write(backend_index)
-    output.write("\n\n")
+    # CLI 项目
+    if project_type == "cli":
+        output.write("## CLI 开发规范\n")
+        cli_index = read_file(
+            trellis_dir / "spec" / "cli" / "index.md", "未配置 CLI 规范"
+        )
+        output.write(cli_index)
+        output.write("\n\n")
+
+    # Frontend 项目
+    if project_type in ("frontend", "fullstack"):
+        output.write("## 前端开发规范\n")
+        frontend_index = read_file(
+            trellis_dir / "spec" / "frontend" / "index.md", "未配置前端规范"
+        )
+        output.write(frontend_index)
+        output.write("\n\n")
+
+    # Backend 项目
+    if project_type in ("backend", "fullstack", "cli"):
+        output.write("## 后端开发规范\n")
+        backend_index = read_file(
+            trellis_dir / "spec" / "backend" / "index.md", "未配置后端规范"
+        )
+        output.write(backend_index)
+        output.write("\n\n")
+
+    # Story 项目
+    if project_type == "story":
+        output.write("## 漫剧创作规范\n")
+        story_index = read_file(
+            trellis_dir / "spec" / "story" / "index.md", "未配置漫剧规范"
+        )
+        output.write(story_index)
+        output.write("\n\n")
 
-    output.write("## Guides\n")
+    # Guides - 始终提供
+    output.write("## 开发指南\n")
     guides_index = read_file(
-        trellis_dir / "spec" / "guides" / "index.md", "Not configured"
+        trellis_dir / "spec" / "guides" / "index.md", "未配置开发指南"
     )
     output.write(guides_index)
 
     output.write("\n</guidelines>\n\n")
 
+    # 读取命令文件 - 必须使用 commands/aim/ 目录（新结构）
+    def read_command_file(filename: str) -> str:
+        """读取 commands/aim/ 目录下的命令文件"""
+        aim_path = claude_dir / "commands" / "aim" / filename
+        if aim_path.exists():
+            return read_file(aim_path, "")
+        return f"未找到命令文件: {filename}"
+
+    # 根据项目类型选择不同的 start 指令
+    if project_type == "story":
+        start_md = read_command_file("story.md")
+    else:
+        start_md = read_command_file("start.md")
+
     output.write("<instructions>\n")
-    start_md = read_file(
-        claude_dir / "commands" / "trellis" / "start.md", "No start.md found"
-    )
     output.write(start_md)
     output.write("\n</instructions>\n\n")
 
+    # 项目类型特定的提示
+    type_hints = {
+        "cli": "注意：这是一个 CLI 工具项目，请参考 spec/cli/ 目录下的规范。",
+        "frontend": "注意：这是一个前端项目，请参考 spec/frontend/ 目录下的规范。",
+        "backend": "注意：这是一个后端项目，请参考 spec/backend/ 目录下的规范。",
+        "fullstack": "注意：这是一个全栈项目，请同时参考 spec/frontend/ 和 spec/backend/ 目录下的规范。",
+        "story": "注意：这是一个漫剧创作项目，请使用 /aim:story 命令开始创作。漫剧命令不适用于其他类型的项目。",
+        "unknown": "注意：项目类型未知，请根据实际情况选择合适的工作流程。",
+    }
+
+    output.write(f"""<project-type-hint>
+{type_hints.get(project_type, '')}
+</project-type-hint>
+
+""")
+
     output.write("""<ready>
-Context loaded. Wait for user's first message, then follow <instructions> to handle their request.
+上下文已加载。请等待用户的第一个消息，然后按照 <instructions> 中的说明处理用户请求。
 </ready>""")
 
     result = {

package/dist/templates/markdown/index.d.ts

@@ -29,4 +29,9 @@ export declare const storyIndexContent: string;
 export declare const storyCharacterContent: string;
 export declare const storyWorldContent: string;
 export declare const storyScriptContent: string;
+export declare const cliIndexContent: string;
+export declare const cliDirectoryStructureContent: string;
+export declare const cliOptionsFlagsContent: string;
+export declare const cliOutputFormattingContent: string;
+export declare const cliErrorHandlingContent: string;
 //# sourceMappingURL=index.d.ts.map

package/dist/templates/markdown/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,eAAO,MAAM,eAAe,EAAE,MAAuC,CAAC;AAGtE,eAAO,MAAM,qBAAqB,EAAE,MACK,CAAC;AAG1C,eAAO,MAAM,yBAAyB,QAAwB,CAAC;AAG/D,eAAO,MAAM,wBAAwB,EAAE,MACH,CAAC;AAQrC,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAElC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AACF,eAAO,MAAM,6BAA6B,EAAE,MAE3C,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAE5C,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,uCAAuC,EAAE,MAErD,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,MAE/B,CAAC;AACF,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AACF,eAAO,MAAM,iBAAiB,EAAE,MAE/B,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,eAAO,MAAM,eAAe,EAAE,MAAuC,CAAC;AAGtE,eAAO,MAAM,qBAAqB,EAAE,MACK,CAAC;AAG1C,eAAO,MAAM,yBAAyB,QAAwB,CAAC;AAG/D,eAAO,MAAM,wBAAwB,EAAE,MACH,CAAC;AAQrC,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAElC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AACF,eAAO,MAAM,6BAA6B,EAAE,MAE3C,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAE5C,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,uCAAuC,EAAE,MACiB,CAAC;AAGxE,eAAO,MAAM,iBAAiB,EAAE,MAE/B,CAAC;AACF,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AACF,eAAO,MAAM,iBAAiB,EAAE,MAE/B,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,MAE7B,CAAC;AACF,eAAO,MAAM,4BAA4B,EAAE,MAE1C,CAAC;AACF,eAAO,MAAM,sBAAsB,EAAE,MAEpC,CAAC;AACF,eAAO,MAAM,0BAA0B,EAAE,MAExC,CAAC;AACF,eAAO,MAAM,uBAAuB,EAAE,MAErC,CAAC"}

package/dist/templates/markdown/index.js

@@ -55,4 +55,10 @@ export const storyIndexContent = readLocalTemplate("spec/story/index.md.txt");
 export const storyCharacterContent = readLocalTemplate("spec/story/character.md.txt");
 export const storyWorldContent = readLocalTemplate("spec/story/world.md.txt");
 export const storyScriptContent = readLocalTemplate("spec/story/script.md.txt");
+// CLI tool structure
+export const cliIndexContent = readLocalTemplate("spec/cli/index.md.txt");
+export const cliDirectoryStructureContent = readLocalTemplate("spec/cli/directory-structure.md.txt");
+export const cliOptionsFlagsContent = readLocalTemplate("spec/cli/options-flags.md.txt");
+export const cliOutputFormattingContent = readLocalTemplate("spec/cli/output-formatting.md.txt");
+export const cliErrorHandlingContent = readLocalTemplate("spec/cli/error-handling.md.txt");
 //# sourceMappingURL=index.js.map

package/dist/templates/markdown/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"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"}

package/dist/templates/markdown/spec/cli/directory-structure.md.txt

@@ -0,0 +1,71 @@
+# CLI Directory Structure
+
+> How the CLI tool is organized.
+
+---
+
+## Overview
+
+Describe your CLI project's directory structure and organization.
+
+---
+
+## Entry Point
+
+| File | Purpose |
+|------|---------|
+| `bin/aim.js` | Main CLI entry point |
+| `src/cli/` | CLI argument parsing |
+| `src/commands/` | Command implementations |
+
+---
+
+## Example Structure
+
+```
+.
+├── bin/
+│   └── aim.js           # CLI entry point
+├── src/
+│   ├── cli/            # Command-line parsing
+│   │   └── index.ts
+│   ├── commands/       # Command implementations
+│   │   ├── init.ts
+│   │   └── update.ts
+│   ├── utils/          # Utility functions
+│   └── types/          # TypeScript types
+├── package.json
+└── tsconfig.json
+```
+
+---
+
+## Patterns
+
+Describe common patterns used in your project:
+
+### Command Organization
+
+```typescript
+// Example: how commands are registered
+export const commands = [init, update];
+```
+
+### Module Boundaries
+
+- `src/cli/` - Pure CLI concerns (parsing, help text)
+- `src/commands/` - Business logic
+- `src/utils/` - Shared utilities
+
+---
+
+## Anti-Patterns
+
+- ❌ Mixing business logic in CLI entry point
+- ❌ No separation between commands
+
+---
+
+## Add Your Examples
+
+Replace these with real examples from your codebase.