monoco-toolkit 0.1.5__py3-none-any.whl → 0.1.7__py3-none-any.whl

monoco/features/i18n/resources/zh/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: monoco-i18n
+description: 文档国际化质量控制。确保多语言文档保持同步。
+---
+
+# 文档国际化
+
+管理 Monoco 项目文档的国际化。
+
+## 概述
+
+I18n 功能提供：
+
+- **自动扫描**缺失的翻译
+- **标准化结构**用于多语言文档
+- **质量控制**以维护文档一致性
+
+## 核心命令
+
+### 扫描缺失的翻译
+
+```bash
+monoco i18n scan
+```
+
+扫描项目中的 markdown 文件并报告缺失的翻译。
+
+**输出**:
+
+- 列出没有对应翻译的源文件
+- 显示缺少哪些目标语言
+- 遵循 `.gitignore` 和默认排除规则
+
+## 配置
+
+I18n 设置在 `.monoco/config.yaml` 中配置：
+
+```yaml
+i18n:
+  source_lang: en # 源语言代码
+  target_langs: # 目标语言代码
+    - zh
+    - ja
+```
+
+## 文档结构
+
+### 根文件（后缀模式）
+
+对于项目根目录中的文件：
+
+- 源文件: `README.md`
+- 中文: `README_ZH.md`
+- 日文: `README_JA.md`
+
+### 子目录文件（目录模式）
+
+对于 `docs/` 或其他目录中的文件：
+
+```
+docs/
+├── en/
+│   ├── guide.md
+│   └── api.md
+├── zh/
+│   ├── guide.md
+│   └── api.md
+└── ja/
+    ├── guide.md
+    └── api.md
+```
+
+## 排除规则
+
+以下内容会自动从 i18n 扫描中排除：
+
+- `.gitignore` 模式（自动遵循）
+- `.references/` 目录
+- 构建产物（`dist/`, `build/`, `node_modules/`）
+- `Issues/` 目录
+
+## 最佳实践
+
+1. **先创建英文版**: 首先用源语言编写文档
+2. **遵循命名约定**: 使用适当的模式（后缀或目录）
+3. **定期运行扫描**: 使用 `monoco i18n scan` 验证覆盖率
+4. **提交所有语言**: 将翻译保存在版本控制中
+
+## 工作流程
+
+1. 用源语言（如英语）编写文档
+2. 按照命名约定创建翻译文件
+3. 运行 `monoco i18n scan` 验证所有翻译是否存在
+4. 修复扫描报告的任何缺失翻译

monoco/features/issue/adapter.py

@@ -0,0 +1,34 @@
+from pathlib import Path
+from typing import Dict
+from monoco.core.feature import MonocoFeature, IntegrationData
+from monoco.features.issue import core
+
+class IssueFeature(MonocoFeature):
+    @property
+    def name(self) -> str:
+        return "issue"
+
+    def initialize(self, root: Path, config: Dict) -> None:
+        issues_path = root / config.get("paths", {}).get("issues", "Issues")
+        core.init(issues_path)
+
+    def integrate(self, root: Path, config: Dict) -> IntegrationData:
+        # Determine language from config, default to 'en'
+        lang = config.get("i18n", {}).get("source_lang", "en")
+        
+        # Current file is in monoco/features/issue/adapter.py
+        # Resource path: monoco/features/issue/resources/{lang}/AGENTS.md
+        base_dir = Path(__file__).parent / "resources"
+        
+        # Try specific language, fallback to 'en'
+        prompt_file = base_dir / lang / "AGENTS.md"
+        if not prompt_file.exists():
+            prompt_file = base_dir / "en" / "AGENTS.md"
+            
+        content = ""
+        if prompt_file.exists():
+            content = prompt_file.read_text(encoding="utf-8").strip()
+            
+        return IntegrationData(
+            system_prompts={"Issue Management": content}
+        )

monoco/features/issue/commands.py

@@ -23,7 +23,7 @@ def create(
     title: str = typer.Option(..., "--title", "-t", help="Issue title"),
     parent: Optional[str] = typer.Option(None, "--parent", "-p", help="Parent Issue ID"),
     is_backlog: bool = typer.Option(False, "--backlog", help="Create as backlog item"),
-    stage: Optional[IssueStage] = typer.Option(None, "--stage", help="Issue stage (todo, doing, review)"),
+    stage: Optional[IssueStage] = typer.Option(None, "--stage", help="Issue stage (draft, doing, review)"),
     dependencies: List[str] = typer.Option([], "--dependency", "-d", help="Issue dependency ID(s)"),
     related: List[str] = typer.Option([], "--related", "-r", help="Related Issue ID(s)"),
     subdir: Optional[str] = typer.Option(None, "--subdir", "-s", help="Subdirectory for organization (e.g. 'Backend/Auth')"),
@@ -73,13 +73,13 @@ def move_open(
     issue_id: str = typer.Argument(..., help="Issue ID to open"),
     root: Optional[str] = typer.Option(None, "--root", help="Override issues root directory"),
 ):
-    """Move issue to open status and set stage to Todo."""
+    """Move issue to open status and set stage to Draft."""
     config = get_config()
     issues_root = _resolve_issues_root(config, root)
     try:
         # Pull operation: Force stage to TODO
-        core.update_issue(issues_root, issue_id, status=IssueStatus.OPEN, stage=IssueStage.TODO)
-        console.print(f"[green]▶[/green] Issue [bold]{issue_id}[/bold] moved to open/todo.")
+        core.update_issue(issues_root, issue_id, status=IssueStatus.OPEN, stage=IssueStage.DRAFT)
+        console.print(f"[green]▶[/green] Issue [bold]{issue_id}[/bold] moved to open/draft.")
     except Exception as e:
         console.print(f"[red]✘ Error:[/red] {str(e)}")
         raise typer.Exit(code=1)
@@ -210,11 +210,11 @@ def pull(
     issue_id: str = typer.Argument(..., help="Issue ID to pull from backlog"),
     root: Optional[str] = typer.Option(None, "--root", help="Override issues root directory"),
 ):
-    """Pull issue from backlog (Open & Todo)."""
+    """Pull issue from backlog (Open & Draft)."""
     config = get_config()
     issues_root = _resolve_issues_root(config, root)
     try:
-        core.update_issue(issues_root, issue_id, status=IssueStatus.OPEN, stage=IssueStage.TODO)
+        core.update_issue(issues_root, issue_id, status=IssueStatus.OPEN, stage=IssueStage.DRAFT)
         console.print(f"[green]🔥[/green] Issue [bold]{issue_id}[/bold] pulled from backlog.")
     except Exception as e:
         console.print(f"[red]✘ Error:[/red] {str(e)}")
@@ -319,7 +319,7 @@ def board(
     columns: List[RenderableType] = []
     
     stage_titles = {
-        "todo": "[bold white]TODO[/bold white]",
+        "draft": "[bold white]DRAFT[/bold white]",
         "doing": "[bold yellow]DOING[/bold yellow]",
         "review": "[bold cyan]REVIEW[/bold cyan]",
         "done": "[bold green]DONE[/bold green]"
@@ -547,7 +547,7 @@ def _resolve_issues_root(config, cli_root: Optional[str]) -> Path:
     # We need to detect if we are in a Workspace Root with multiple projects
     cwd = Path.cwd()
     
-    # If CWD is NOT a project root (no monoco.yaml/Issues), scan for subprojects
+    # If CWD is NOT a project root (no .monoco/), scan for subprojects
     if not is_project_root(cwd):
         subprojects = find_projects(cwd)
         if len(subprojects) > 1:

monoco/features/issue/core.py

@@ -583,15 +583,6 @@ description: Monoco Issue System 的官方技能定义。将 Issue 视为通用
 5. **Modification**: `monoco issue start/submit/delete <id>`
 """
 
-PROMPT_CONTENT = """
-### Issue Management
-System for managing tasks using `monoco issue`.
-- **Create**: `monoco issue create <type> -t "Title"` (types: epic, feature, chore, fix)
-- **Status**: `monoco issue open|close|backlog <id>`
-- **Check**: `monoco issue lint` (Must run after manual edits)
-- **Lifecycle**: `monoco issue start|submit|delete <id>`
-- **Structure**: `Issues/{CapitalizedPluralType}/{lowercase_status}/` (e.g. `Issues/Features/open/`). Do not deviate.
-"""
 
 def init(issues_root: Path):
     """Initialize the Issues directory structure."""
@@ -612,9 +603,7 @@ def get_resources() -> Dict[str, Any]:
         "skills": {
             "issues-management": SKILL_CONTENT
         },
-        "prompts": {
-            "issues-management": PROMPT_CONTENT
-        }
+        "prompts": {} # Handled by adapter via resource files
     }
 
 
@@ -662,7 +651,7 @@ def get_board_data(issues_root: Path) -> Dict[str, List[IssueMetadata]]:
     Get open issues grouped by their stage for Kanban view.
     """
     board = {
-        IssueStage.TODO.value: [],
+        IssueStage.DRAFT.value: [],
         IssueStage.DOING.value: [],
         IssueStage.REVIEW.value: [],
         IssueStage.DONE.value: []
@@ -1042,11 +1031,11 @@ def recalculate_parent(issues_root: Path, parent_id: str):
         # FEAT-0003 Req: "If first child starts doing, auto-start Parent?"
         # If parent is OPEN/TODO and child is DOING/REVIEW/DONE, set parent to DOING?
         current_status = data.get("status", "open").lower()
-        current_stage = data.get("stage", "todo").lower()
+        current_stage = data.get("stage", "draft").lower()
         
-        if current_status == "open" and current_stage == "todo":
+        if current_status == "open" and current_stage == "draft":
             # Check if any child is active
-            active_children = [c for c in children if c.status == IssueStatus.OPEN and c.stage != IssueStage.TODO]
+            active_children = [c for c in children if c.status == IssueStatus.OPEN and c.stage != IssueStage.DRAFT]
             closed_children = [c for c in children if c.status == IssueStatus.CLOSED]
             
             if active_children or closed_children:

monoco/features/issue/migration.py

@@ -0,0 +1,134 @@
+import os
+import re
+import yaml
+import hashlib
+import secrets
+from pathlib import Path
+from typing import List, Dict, Any
+from datetime import datetime
+from .models import generate_uid
+
+# Migration Mappings
+DIR_MAP = {
+    "STORIES": "Features",
+    "Stories": "Features",
+    "TASKS": "Chores",
+    "Tasks": "Chores",
+    "BUGS": "Fixes",
+    "Bugs": "Fixes",
+    "EPICS": "Epics",
+    "Epics": "Epics",
+    "features": "Features",
+    "chores": "Chores",
+    "fixes": "Fixes",
+    "epics": "Epics"
+}
+
+TYPE_MAP = {
+    "story": "feature",
+    "task": "chore",
+    "bug": "fix"
+}
+
+ID_PREFIX_MAP = {
+    "STORY": "FEAT",
+    "TASK": "CHORE",
+    "BUG": "FIX"
+}
+
+def migrate_issues_directory(issues_dir: Path):
+    """
+    Core migration logic to upgrade an Issues directory to the latest Monoco standard.
+    """
+    if not issues_dir.exists():
+        return
+
+    # 1. Rename Directories
+    for old_name, new_name in DIR_MAP.items():
+        old_path = issues_dir / old_name
+        if old_path.exists():
+            new_path = issues_dir / new_name
+            
+            # Case sensitivity check for some filesystems
+            same_inode = False
+            try:
+                if new_path.exists() and os.path.samefile(old_path, new_path):
+                    same_inode = True
+            except OSError:
+                pass
+
+            if same_inode:
+                if old_path.name != new_path.name:
+                    old_path.rename(new_path)
+                continue
+
+            if new_path.exists():
+                import shutil
+                for item in old_path.iterdir():
+                    dest = new_path / item.name
+                    if dest.exists() and item.is_dir():
+                        for subitem in item.iterdir():
+                            shutil.move(str(subitem), str(dest / subitem.name))
+                        shutil.rmtree(item)
+                    else:
+                        shutil.move(str(item), str(dest))
+                shutil.rmtree(old_path)
+            else:
+                old_path.rename(new_path)
+
+    # 2. Rename Files and Update Content
+    for subdir_name in ["Features", "Chores", "Fixes", "Epics"]:
+        subdir = issues_dir / subdir_name
+        if not subdir.exists():
+            continue
+            
+        for file_path in subdir.rglob("*.md"):
+            content = file_path.read_text(encoding="utf-8")
+            new_content = content
+            
+            # Replace Type in Frontmatter
+            for old_type, new_type in TYPE_MAP.items():
+                new_content = re.sub(rf"^type:\s*{old_type}", f"type: {new_type}", new_content, flags=re.IGNORECASE | re.MULTILINE)
+            
+            # Replace ID Prefixes
+            for old_prefix, new_prefix in ID_PREFIX_MAP.items():
+                new_content = new_content.replace(f"[[{old_prefix}-", f"[[{new_prefix}-")
+                new_content = re.sub(rf"^id: {old_prefix}-", f"id: {new_prefix}-", new_content, flags=re.MULTILINE)
+                new_content = re.sub(rf"^parent: {old_prefix}-", f"parent: {new_prefix}-", new_content, flags=re.MULTILINE)
+                new_content = new_content.replace(f"{old_prefix}-", f"{new_prefix}-")
+
+            # Structural Updates (UID, Stage)
+            match = re.search(r"^---(.*?)---", new_content, re.DOTALL | re.MULTILINE)
+            if match:
+                yaml_str = match.group(1)
+                try:
+                    data = yaml.safe_load(yaml_str) or {}
+                    changed = False
+                    
+                    if 'uid' not in data:
+                        data['uid'] = generate_uid()
+                        changed = True
+                        
+                    if 'stage' in data and data['stage'] == 'todo':
+                        data['stage'] = 'draft'
+                        changed = True
+                            
+                    if changed:
+                         new_yaml = yaml.dump(data, sort_keys=False, allow_unicode=True)
+                         new_content = new_content.replace(match.group(1), "\n" + new_yaml)
+                except yaml.YAMLError:
+                    pass
+
+            if new_content != content:
+                file_path.write_text(new_content, encoding="utf-8")
+
+            # Rename File
+            filename = file_path.name
+            new_filename = filename
+            for old_prefix, new_prefix in ID_PREFIX_MAP.items():
+                if filename.startswith(f"{old_prefix}-"):
+                    new_filename = filename.replace(f"{old_prefix}-", f"{new_prefix}-", 1)
+                    break
+            
+            if new_filename != filename:
+                file_path.rename(file_path.parent / new_filename)

monoco/features/issue/models.py

@@ -61,7 +61,7 @@ class IssueStatus(str, Enum):
     BACKLOG = "backlog"
 
 class IssueStage(str, Enum):
-    TODO = "todo"
+    DRAFT = "draft"
     DOING = "doing"
     REVIEW = "review"
     DONE = "done"
@@ -125,6 +125,8 @@ class IssueMetadata(BaseModel):
             # Stage normalization
             if "stage" in v and isinstance(v["stage"], str):
                 v["stage"] = v["stage"].lower()
+                if v["stage"] == "todo":
+                    v["stage"] = "draft"
         return v
 
     @model_validator(mode='after')
@@ -132,7 +134,7 @@ class IssueMetadata(BaseModel):
         # Logic Definition:
         # status: backlog -> stage: null
         # status: closed -> stage: done
-        # status: open -> stage: todo | doing | review (default todo)
+        # status: open -> stage: draft | doing | review (default draft)
 
         if self.status == IssueStatus.BACKLOG:
             self.stage = IssueStage.FREEZED
@@ -148,7 +150,7 @@ class IssueMetadata(BaseModel):
         elif self.status == IssueStatus.OPEN:
             # Ensure valid stage for open status
             if self.stage is None or self.stage == IssueStage.DONE:
-                self.stage = IssueStage.TODO
+                self.stage = IssueStage.DRAFT
         
         return self
 

monoco/features/issue/resources/en/AGENTS.md

@@ -0,0 +1,9 @@
+### Issue Management
+
+System for managing tasks using `monoco issue`.
+
+- **Create**: `monoco issue create <type> -t "Title"` (types: epic, feature, chore, fix)
+- **Status**: `monoco issue open|close|backlog <id>`
+- **Check**: `monoco issue lint` (Must run after manual edits)
+- **Lifecycle**: `monoco issue start|submit|delete <id>`
+- **Structure**: `Issues/{CapitalizedPluralType}/{lowercase_status}/` (e.g. `Issues/Features/open/`). Do not deviate.

monoco/features/issue/resources/en/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: monoco-issue
+description: Official skill for Monoco Issue System. Treats Issues as Universal Atoms, managing the lifecycle of Epic/Feature/Chore/Fix.
+---
+
+# Issue Management
+
+Use this skill to create and manage **Issues** (Universal Atoms) in Monoco projects.
+
+## Core Ontology
+
+### 1. Strategy Layer
+
+- **🏆 EPIC**: Grand goals, vision containers. Mindset: Architect.
+
+### 2. Value Layer
+
+- **✨ FEATURE**: Value increments from user perspective. Mindset: Product Owner.
+- **Atomicity Principle**: Feature = Design + Dev + Test + Doc + i18n. They are one.
+
+### 3. Execution Layer
+
+- **🧹 CHORE**: Engineering maintenance, no direct user value. Mindset: Builder.
+- **🐞 FIX**: Correcting deviations. Mindset: Debugger.
+
+## Guidelines
+
+### Directory Structure
+
+`Issues/{CapitalizedPluralType}/{lowercase_status}/`
+
+- `{TYPE}`: `Epics`, `Features`, `Chores`, `Fixes`
+- `{STATUS}`: `open`, `backlog`, `closed`
+
+### Path Transitions
+
+Use `monoco issue`:
+
+1. **Create**: `monoco issue create <type> --title "..."`
+
+   - Params: `--parent <id>`, `--dependency <id>`, `--related <id>`, `--sprint <id>`, `--tags <tag>`
+
+2. **Transition**: `monoco issue open/close/backlog <id>`
+
+3. **View**: `monoco issue scope`
+
+4. **Validation**: `monoco issue lint`
+
+5. **Modification**: `monoco issue start/submit/delete <id>`
+
+6. **Commit**: `monoco issue commit` (Atomic commit for issue files)

monoco/features/issue/resources/zh/AGENTS.md

@@ -0,0 +1,9 @@
+### Issue 管理
+
+使用 `monoco issue` 管理任务的系统。
+
+- **创建**: `monoco issue create <type> -t "标题"` (类型: epic, feature, chore, fix)
+- **状态**: `monoco issue open|close|backlog <id>`
+- **检查**: `monoco issue lint` (手动编辑后必须运行)
+- **生命周期**: `monoco issue start|submit|delete <id>`
+- **结构**: `Issues/{CapitalizedPluralType}/{lowercase_status}/` (例如 `Issues/Features/open/`)。不要偏离此结构。

monoco/features/issue/resources/zh/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: monoco-issue
+description: Monoco Issue System 的官方技能定义。将 Issue 视为通用原子 (Universal Atom)，管理 Epic/Feature/Chore/Fix 的生命周期。
+---
+
+# 自我管理 (Monoco Issue System)
+
+使用此技能在 Monoco 项目中创建和管理 **Issue** (通用原子)。该系统参考 Jira 表达体系，同时保持 "建设者 (Builder)" 和 "调试者 (Debugger)" 思维模式的隔离。
+
+## 核心本体论 (Core Ontology)
+
+Monoco 不仅仅复刻 Jira，而是基于 **"思维模式 (Mindset)"** 重新定义工作单元。
+
+### 1. 战略层 (Strategy)
+
+#### 🏆 EPIC (史诗)
+
+- **Mindset**: _Architect_ (架构师)
+- **定义**: 跨越多个周期的宏大目标。它不是单纯的"大任务"，而是"愿景的容器"。
+- **产出**: 定义了系统的边界和核心价值。
+
+### 2. 价值层 (Value)
+
+#### ✨ FEATURE (特性)
+
+- **Mindset**: _Product Owner_ (产品负责人)
+- **定义**: 用户视角的价值增量。必须是可独立交付 (Shippable) 的垂直切片。
+- **Focus**: "Why" & "What" (用户想要什么？)。
+- **Prefix**: `FEAT-`
+
+### 3. 执行层 (Execution)
+
+#### 🧹 CHORE (杂务)
+
+- **Mindset**: _Builder_ (建设者)
+- **定义**: **不产生**直接用户价值的工程性事务。
+- **场景**: 架构升级、写构建脚本、修复 CI/CD 流水线。
+- **Focus**: "How" (为了支撑系统运转，必须做什么)。
+- **Prefix**: `CHORE-`
+
+_(取代了 Task 概念)_
+
+#### 🐞 FIX (修复)
+
+- **Mindset**: _Debugger_ (调试者)
+- **定义**: 预期与现实的偏差。它是负价值的修正。
+- **Focus**: "Fix" (恢复原状)。
+- **Prefix**: `FIX-`
+
+_(取代了 Bug 概念)_
+
+---
+
+**关系链**:
+
+- **主要**: `EPIC` (愿景) -> `FEATURE` (价值交付单元)
+- **次要**: `CHORE` (工程维护/支撑) - 通常独立存在。
+- **原子性原则**: Feature = Design + Dev + Test + Doc + i18n。它们是一体的。
+
+## 准则 (Guidelines)
+
+### 目录结构
+
+`Issues/{CapitalizedPluralType}/{lowercase_status}/`
+
+- `{TYPE}`: `Epics`, `Features`, `Chores`, `Fixes`
+- `{STATUS}`: `open`, `backlog`, `closed`
+
+### 路径流转
+
+使用 `monoco issue`：
+
+1. **Create**: `monoco issue create <type> --title "..."`
+
+   - Params: `--parent <id>`, `--dependency <id>`, `--related <id>`, `--sprint <id>`, `--tags <tag>`
+
+2. **Transition**: `monoco issue open/close/backlog <id>`
+
+3. **View**: `monoco issue scope`
+
+4. **Validation**: `monoco issue lint`
+
+5. **Modification**: `monoco issue start/submit/delete <id>`
+
+6. **Commit**: `monoco issue commit` (Atomic commit for issue files)

monoco/features/spike/adapter.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+from typing import Dict
+from monoco.core.feature import MonocoFeature, IntegrationData
+from monoco.features.spike import core
+
+class SpikeFeature(MonocoFeature):
+    @property
+    def name(self) -> str:
+        return "spike"
+
+    def initialize(self, root: Path, config: Dict) -> None:
+        spikes_name = config.get("paths", {}).get("spikes", ".references")
+        core.init(root, spikes_name)
+
+    def integrate(self, root: Path, config: Dict) -> IntegrationData:
+        # Determine language from config, default to 'en'
+        lang = config.get("i18n", {}).get("source_lang", "en")
+        base_dir = Path(__file__).parent / "resources"
+        
+        prompt_file = base_dir / lang / "AGENTS.md"
+        if not prompt_file.exists():
+            prompt_file = base_dir / "en" / "AGENTS.md"
+            
+        content = ""
+        if prompt_file.exists():
+            content = prompt_file.read_text(encoding="utf-8").strip()
+
+        return IntegrationData(
+            system_prompts={"Spike (Research)": content}
+        )

monoco/features/spike/core.py

@@ -31,17 +31,10 @@ def run_git_command(cmd: List[str], cwd: Path) -> bool:
 
 def get_config_file_path(root: Path) -> Path:
     """Determine the config file to update."""
-    # Priority 1: .monoco/config.yaml
+    # Standard: .monoco/config.yaml
     hidden = root / ".monoco" / "config.yaml"
-    if hidden.exists():
-        return hidden
     
-    # Priority 2: monoco.yaml
-    visible = root / "monoco.yaml"
-    if visible.exists():
-        return visible
-    
-    # Default to .monoco/config.yaml for new files
+    # Ensure parent exists
     hidden.parent.mkdir(exist_ok=True)
     return hidden
 
@@ -131,24 +124,14 @@ This skill normalizes how we introduce external code repositories.
 3. **Remove**: `monoco spike remove <name>`
 """
 
-PROMPT_CONTENT = """### Spike (Research)
-Manage external reference repositories.
-- **Add Repo**: `monoco spike add <url>` (Available in `.reference/<name>` for reading)
-- **Sync**: `monoco spike sync` (Run to download content)
-- **Constraint**: Never edit files in `.reference/`. Treat them as read-only external knowledge."""
-
 def init(root: Path, spikes_dir_name: str):
     """Initialize Spike environment."""
     ensure_gitignore(root, spikes_dir_name)
     (root / spikes_dir_name).mkdir(exist_ok=True)
 
-def get_resources() -> Dict[str, Any]:
     return {
         "skills": {
             "git-repo-spike": SKILL_CONTENT
         },
-        "prompts": {
-            "spike": PROMPT_CONTENT
-        }
+        "prompts": {} # Handled by adapter via resource files
     }
-

monoco/features/spike/resources/en/AGENTS.md

@@ -0,0 +1,7 @@
+### Spike (Research)
+
+Manage external reference repositories.
+
+- **Add Repo**: `monoco spike add <url>` (Available in `.reference/<name>` for reading)
+- **Sync**: `monoco spike sync` (Run to download content)
+- **Constraint**: Never edit files in `.reference/`. Treat them as read-only external knowledge.