@chinhae/atw-cli 0.3.6 → 0.4.0

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

@@ -132,6 +132,24 @@ def read_file(path: Path, fallback: str = "") -> str:
         return fallback
 
 
+def _conventions_context(project_dir: Path) -> str:
+    """The `<conventions>` block of a `general` project, else "".
+
+    A general project has one flat conventions file instead of per-package,
+    per-layer guideline indexes. An install whose scripts predate the helper is
+    treated as a dev project.
+    """
+    scripts_dir = project_dir / ".atw" / "scripts"
+    if str(scripts_dir) not in sys.path:
+        sys.path.insert(0, str(scripts_dir))
+    try:
+        from common.session_context import conventions_context  # type: ignore[import-not-found]
+
+        return conventions_context(project_dir)
+    except Exception:
+        return ""
+
+
 def _resolve_context_key(project_dir: Path, hook_input: dict) -> str | None:
     scripts_dir = project_dir / ".atw" / "scripts"
     if str(scripts_dir) not in sys.path:
@@ -203,9 +221,20 @@ def _resolve_task_dir(atw_dir: Path, task_ref: str) -> Path:
     return atw_dir / "tasks" / path_obj
 
 
-def _get_task_status(atw_dir: Path, hook_input: dict) -> str:
+def _get_task_status(atw_dir: Path, hook_input: dict, general: bool = False) -> str:
+    """Compact active-task status and next action.
+
+    In a `general` project the AI decides on its own whether a request gets a
+    task, so the no-task line defers to the workflow instead of telling it to
+    ask first.
+    """
     active = _resolve_active_task(atw_dir, hook_input)
     if not active.task_path:
+        if general:
+            return (
+                "Status: NO ACTIVE TASK\n"
+                "Next: Do what <atw-workflow> above says for a session with no current task."
+            )
         return (
             "Status: NO ACTIVE TASK\n"
             "Next: Classify the current turn and ask for task-creation consent "
@@ -232,6 +261,13 @@ def _get_task_status(atw_dir: Path, hook_input: dict) -> str:
     task_status = task_data.get("status", "unknown")
 
     if task_status == "completed":
+        if general:
+            # general 的任务不记分支；在有远端的仓库里不带这个开关归档会被拒绝。
+            return (
+                f"Status: COMPLETED\nTask: {task_title}\n"
+                "Next: The archive was interrupted. Finish it with "
+                f"`python3 ./.atw/scripts/task.py archive {task_dir.name} --skip-branch-validation`."
+            )
         return (
             f"Status: COMPLETED\nTask: {task_title}\n"
             f"Next: Archive with `python3 ./.atw/scripts/task.py archive {task_dir.name}` "
@@ -249,6 +285,12 @@ def _get_task_status(atw_dir: Path, hook_input: dict) -> str:
     if not has_prd:
         # 这条不以任务状态为门，任何阶段缺 prd.md 都会进——所以状态名要照实报，
         # 不能像以前那样硬编码成一个词表里已经没有的阶段。
+        if general:
+            # general 不装头脑风暴技能，prd.md 由 AI 照流程自己写。
+            return (
+                f"Status: {task_status.upper()}\nTask: {task_title}\nPresent: {present_line}\n"
+                "Next: Write prd.md as <atw-workflow> above says before task.py start."
+            )
         return (
             f"Status: {task_status.upper()}\nTask: {task_title}\nPresent: {present_line}\n"
             "Next: Load atw-brainstorm and write prd.md before task.py start."
@@ -281,6 +323,9 @@ def _run_git(repo_root: Path, args: list[str]) -> str:
 
 
 def _format_git_state(repo_root: Path) -> str:
+    # 普通文件夹没有分支，也谈不上干净：照实说，不编一个状态出来。
+    if _run_git(repo_root, ["rev-parse", "--is-inside-work-tree"]) != "true":
+        return "Git: not a git repository."
     branch = _run_git(repo_root, ["branch", "--show-current"]) or "(detached)"
     dirty_lines = [
         line for line in _run_git(repo_root, ["status", "--porcelain"]).splitlines()
@@ -453,7 +498,10 @@ def main() -> None:
     configure_project_encoding(project_dir)
 
     atw_dir = project_dir / ".atw"
-    spec_index_paths = _collect_spec_index_paths(atw_dir)
+    # A general project keeps no guideline indexes — whatever a switch from dev
+    # left under `.atw/spec/` is not offered there.
+    conventions = _conventions_context(project_dir)
+    spec_index_paths = [] if conventions else _collect_spec_index_paths(atw_dir)
 
     output = StringIO()
 
@@ -473,24 +521,27 @@ ATW compact SessionStart context. Use it to orient the session; load details on
     output.write(_build_workflow_toc(atw_dir / "workflow.md"))
     output.write("\n</atw-workflow>\n\n")
 
-    output.write("<guidelines>\n")
-    output.write(
-        "Task context order for implementation/check: jsonl entries -> `prd.md`.\n\n"
-    )
+    if conventions:
+        output.write(f"{conventions}\n\n")
+    else:
+        output.write("<guidelines>\n")
+        output.write(
+            "Task context order for implementation/check: jsonl entries -> `prd.md`.\n\n"
+        )
 
-    if spec_index_paths:
-        output.write("## Available indexes (read on demand)\n")
-        for p in spec_index_paths:
-            output.write(f"- {p}\n")
-        output.write("\n")
-
-    output.write(
-        "Discover more via: "
-        "`python3 ./.atw/scripts/get_context.py --mode packages`\n"
-    )
-    output.write("</guidelines>\n\n")
+        if spec_index_paths:
+            output.write("## Available indexes (read on demand)\n")
+            for p in spec_index_paths:
+                output.write(f"- {p}\n")
+            output.write("\n")
+
+        output.write(
+            "Discover more via: "
+            "`python3 ./.atw/scripts/get_context.py --mode packages`\n"
+        )
+        output.write("</guidelines>\n\n")
 
-    task_status = _get_task_status(atw_dir, hook_input)
+    task_status = _get_task_status(atw_dir, hook_input, general=bool(conventions))
     output.write(f"<task-status>\n{task_status}\n</task-status>\n\n")
 
     output.write("""<ready>

package/dist/templates/common/bundled-skills/atw-noob-mode/SKILL.md

@@ -7,18 +7,20 @@ description: "小白模式：给不懂技术的用户全程用大白话沟通—
 
 The user is not an engineer. They are still the one in charge: they decide what gets built, what is good enough, and what must not happen. They can only do that when they understand what you tell them and what you are about to do. An update they cannot read leaves them able to approve your work but not to review it — and then your choices ship unexamined.
 
-Noob mode keeps every reply, in every ATW stage, in language they can act on. It starts when it is switched on and lasts until the user switches it off.
+Noob mode keeps every reply, in every ATW stage, in language they can act on. In a `general` project it is on from the start; in a `dev` project it starts when it is switched on. Either way it lasts until the user switches it off.
 
 ## Switching
 
+Each user is in one of three states: switched on, switched off, or never chose. On and off are the user's own choice and always win. A user who never chose gets the project's default — on in a `general` project, off in a `dev` one (a project whose `.atw/config.yaml` has no `mode` entry is `dev`).
+
 The user's words or the argument decide the action. With neither, turn it on — unless you loaded this skill yourself because the `<noob-mode>` reminder told you to, which is "Already on" below.
 
 - **On** — `/atw-noob-mode`, "开启小白模式", "turn on noob mode", or the user says they cannot follow the terms, an approval prompt, an error or command output. Run `python3 ./.atw/scripts/noob_mode.py on`, then confirm in the user's language, for example: "小白模式已开启。接下来我会用大白话说明我在做什么、需要你决定什么、有什么风险。随时可以说“关闭小白模式”。" Apply everything below from that reply on, then do the catch-up in "Catching up".
-- **Off** — `/atw-noob-mode off`, "关闭小白模式", "turn off noob mode". Run `python3 ./.atw/scripts/noob_mode.py off`, confirm in one sentence, and stop applying these rules.
-- **Status** — `python3 ./.atw/scripts/noob_mode.py status`.
+- **Off** — `/atw-noob-mode off`, "关闭小白模式", "turn off noob mode". Run `python3 ./.atw/scripts/noob_mode.py off`, confirm in one sentence, and stop applying these rules. Off is recorded as the user's choice: the project default will not turn it back on, and neither will a change of project mode.
+- **Status** — `python3 ./.atw/scripts/noob_mode.py status`. It prints whether the mode is on, and a `Source:` line saying whether that is the user's own setting or the project default.
 - **Already on** — you loaded this skill yourself because the `<noob-mode>` reminder told you to. Nothing is being switched: run no script and announce nothing. Read on, and apply all of it starting with the reply you are about to write.
 
-The switch is personal: it is a line in this user's own `.atw/.developer`, which is never committed, so teammates are unaffected. While it is on, ATW hands you a `<noob-mode>` reminder at session start and on every turn — that is what makes the mode last through long conversations and new sessions. The reminder carries only the core of these rules. When the text of this skill is not in front of you — a new session, or a long conversation that has been summarized — load it before you reply: the reminder alone leaves out most of what is here, limits included. If the script fails, tell the user plainly and still follow the rules for this conversation.
+The choice is personal: it is a line in this user's own `.atw/.developer`, which is never committed, so teammates are unaffected. While it is on, ATW hands you a `<noob-mode>` reminder at session start and on every turn — that is what makes the mode last through long conversations and new sessions. The reminder carries only the core of these rules. When the text of this skill is not in front of you — a new session, or a long conversation that has been summarized — load it before you reply: the reminder alone leaves out most of what is here, limits included. If the script fails, tell the user plainly and still follow the rules for this conversation.
 
 Never switch it off on your own, and never drift out of it because a stage is long or technical. Only the user ends it.
 

package/dist/templates/common/commands/start.md

@@ -1,3 +1,4 @@
+{{^MODE_GENERAL}}
 # Start Session
 
 Initialize an ATW-managed development session. This platform has no session-start hook, so manually load the equivalent compact context by following these steps.
@@ -66,3 +67,45 @@ Load the step detail before acting on it:
 | Learned something worth capturing | `atw-update-spec` |
 
 Full rules + anti-rationalization table in `.atw/workflow.md`.
+{{/MODE_GENERAL}}
+{{#MODE_GENERAL}}
+# Start Session
+
+Load this project's ATW context. This platform has no session-start hook, so do it by hand with the steps below.
+
+---
+
+## Step 1: Current state
+Who you are working with, the current task, unfinished tasks, where the journal is, and the project's conventions.
+
+```bash
+{{PYTHON_CMD}} ./.atw/scripts/get_context.py
+```
+
+If this output includes a line beginning `ATW update available:`, copy the full line verbatim when summarizing session context. Do not shorten operational command hints.
+
+## Step 2: Workflow overview
+How work goes in this project, and what to do at each task status.
+
+```bash
+{{PYTHON_CMD}} ./.atw/scripts/get_context.py --mode phase
+```
+
+Full guide in `.atw/workflow.md` (read on demand).
+
+## Step 3: Conventions
+`.atw/spec/conventions.md` is the one place this project keeps what the user asked for more than once. Step 1 printed it inside `<conventions>`: follow it in every reply. If that block was missing, read the file itself:
+
+```bash
+cat .atw/spec/conventions.md
+```
+
+## Step 4: Decide next action
+Step 1 gave you the current task and its `status`; Step 2 told you what the workflow does at that status. Do that. With no current task, do what the workflow says for a session that has none.
+
+To read one step of the workflow in full:
+
+```bash
+{{PYTHON_CMD}} ./.atw/scripts/get_context.py --mode phase --step <X.Y> --platform {{CLI_FLAG}}
+```
+{{/MODE_GENERAL}}

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

@@ -131,6 +131,24 @@ def read_file(path: Path, fallback: str = "") -> str:
         return fallback
 
 
+def _conventions_context(project_dir: Path) -> str:
+    """The `<conventions>` block of a `general` project, else "".
+
+    A general project has one flat conventions file instead of per-package,
+    per-layer guideline indexes. An install whose scripts predate the helper is
+    treated as a dev project.
+    """
+    scripts_dir = project_dir / ".atw" / "scripts"
+    if str(scripts_dir) not in sys.path:
+        sys.path.insert(0, str(scripts_dir))
+    try:
+        from common.session_context import conventions_context  # type: ignore[import-not-found]
+
+        return conventions_context(project_dir)
+    except Exception:
+        return ""
+
+
 def _resolve_context_key(project_dir: Path, hook_input: dict) -> str | None:
     scripts_dir = project_dir / ".atw" / "scripts"
     if str(scripts_dir) not in sys.path:
@@ -202,9 +220,20 @@ def _resolve_task_dir(atw_dir: Path, task_ref: str) -> Path:
     return atw_dir / "tasks" / path_obj
 
 
-def _get_task_status(atw_dir: Path, hook_input: dict) -> str:
+def _get_task_status(atw_dir: Path, hook_input: dict, general: bool = False) -> str:
+    """Compact active-task status and next action.
+
+    In a `general` project the AI decides on its own whether a request gets a
+    task, so the no-task line defers to the workflow instead of telling it to
+    ask first.
+    """
     active = _resolve_active_task(atw_dir, hook_input)
     if not active.task_path:
+        if general:
+            return (
+                "Status: NO ACTIVE TASK\n"
+                "Next: Do what <atw-workflow> above says for a session with no current task."
+            )
         return (
             "Status: NO ACTIVE TASK\n"
             "Next: Classify the current turn and ask for task-creation consent "
@@ -231,6 +260,13 @@ def _get_task_status(atw_dir: Path, hook_input: dict) -> str:
     task_status = task_data.get("status", "unknown")
 
     if task_status == "completed":
+        if general:
+            # general 的任务不记分支；在有远端的仓库里不带这个开关归档会被拒绝。
+            return (
+                f"Status: COMPLETED\nTask: {task_title}\n"
+                "Next: The archive was interrupted. Finish it with "
+                f"`python3 ./.atw/scripts/task.py archive {task_dir.name} --skip-branch-validation`."
+            )
         return (
             f"Status: COMPLETED\nTask: {task_title}\n"
             f"Next: Archive with `python3 ./.atw/scripts/task.py archive {task_dir.name}` "
@@ -248,6 +284,12 @@ def _get_task_status(atw_dir: Path, hook_input: dict) -> str:
     if not has_prd:
         # 这条不以任务状态为门，任何阶段缺 prd.md 都会进——所以状态名要照实报，
         # 不能像以前那样硬编码成一个词表里已经没有的阶段。
+        if general:
+            # general 不装头脑风暴技能，prd.md 由 AI 照流程自己写。
+            return (
+                f"Status: {task_status.upper()}\nTask: {task_title}\nPresent: {present_line}\n"
+                "Next: Write prd.md as <atw-workflow> above says before task.py start."
+            )
         return (
             f"Status: {task_status.upper()}\nTask: {task_title}\nPresent: {present_line}\n"
             "Next: Load atw-brainstorm and write prd.md before task.py start."
@@ -280,6 +322,9 @@ def _run_git(repo_root: Path, args: list[str]) -> str:
 
 
 def _format_git_state(repo_root: Path) -> str:
+    # 普通文件夹没有分支，也谈不上干净：照实说，不编一个状态出来。
+    if _run_git(repo_root, ["rev-parse", "--is-inside-work-tree"]) != "true":
+        return "Git: not a git repository."
     branch = _run_git(repo_root, ["branch", "--show-current"]) or "(detached)"
     dirty_lines = [
         line for line in _run_git(repo_root, ["status", "--porcelain"]).splitlines()
@@ -452,7 +497,10 @@ def main() -> None:
     configure_project_encoding(project_dir)
 
     atw_dir = project_dir / ".atw"
-    spec_index_paths = _collect_spec_index_paths(atw_dir)
+    # A general project keeps no guideline indexes — whatever a switch from dev
+    # left under `.atw/spec/` is not offered there.
+    conventions = _conventions_context(project_dir)
+    spec_index_paths = [] if conventions else _collect_spec_index_paths(atw_dir)
 
     output = StringIO()
 
@@ -470,24 +518,27 @@ ATW compact SessionStart context. Use it to orient the session; load details on
     output.write(_build_workflow_toc(atw_dir / "workflow.md"))
     output.write("\n</atw-workflow>\n\n")
 
-    output.write("<guidelines>\n")
-    output.write(
-        "Task context order for implementation/check: jsonl entries -> `prd.md`.\n\n"
-    )
+    if conventions:
+        output.write(f"{conventions}\n\n")
+    else:
+        output.write("<guidelines>\n")
+        output.write(
+            "Task context order for implementation/check: jsonl entries -> `prd.md`.\n\n"
+        )
 
-    if spec_index_paths:
-        output.write("## Available indexes (read on demand)\n")
-        for p in spec_index_paths:
-            output.write(f"- {p}\n")
-        output.write("\n")
-
-    output.write(
-        "Discover more via: "
-        "`python3 ./.atw/scripts/get_context.py --mode packages`\n"
-    )
-    output.write("</guidelines>\n\n")
+        if spec_index_paths:
+            output.write("## Available indexes (read on demand)\n")
+            for p in spec_index_paths:
+                output.write(f"- {p}\n")
+            output.write("\n")
+
+        output.write(
+            "Discover more via: "
+            "`python3 ./.atw/scripts/get_context.py --mode packages`\n"
+        )
+        output.write("</guidelines>\n\n")
 
-    task_status = _get_task_status(atw_dir, hook_input)
+    task_status = _get_task_status(atw_dir, hook_input, general=bool(conventions))
     output.write(f"<task-status>\n{task_status}\n</task-status>\n\n")
 
     output.write("""<ready>

package/dist/templates/dsh/DSH.md

@@ -4,6 +4,7 @@ dsh is a **class-2 pull-based** ATW host: no session-start hook auto-injects
 workflow context, so the agent loads the ATW skills on demand through its
 skill-loader tool.
 
+{{^MODE_GENERAL}}
 | Capability | Status |
 | --- | --- |
 | Skills (`.agents/skills/atw-*/SKILL.md`) | Works — dsh discovers this shared root natively |
@@ -44,6 +45,46 @@ In dsh:
 - `.atw/` — specs, tasks, workspace memory, and the shared scripts the
   skills invoke (`get_context.py`, `task.py`, ...).
 
+{{/MODE_GENERAL}}
+{{#MODE_GENERAL}}
+This project is in ATW's `general` mode, for work that is not code: you say
+what you want in your own words, and the workflow in `.atw/workflow.md` has
+the agent do the rest.
+
+| Capability | Status |
+| --- | --- |
+| Skills (`.agents/skills/atw-*/SKILL.md`) | Works — dsh discovers this shared root natively |
+| Entry skill (`.dsh/skills/atw-start/SKILL.md`) | Works — dsh's own project skill root (highest rank) |
+| Context hooks | None — pull-based: skills read `.atw/` files directly |
+| Sub-agents | None |
+
+## Quick start
+
+```bash
+atw init --dsh --mode general -u your-name
+dsh web        # or: dsh --profile headless "plan ..."
+```
+
+In dsh:
+
+1. Open a session in the project root and say what you want done. The agent
+   should first load the `atw-start` skill, which reads the current task,
+   the workflow and the project's conventions from `.atw/`.
+2. There is nothing else to ask for by name. The workflow has the agent keep
+   the task record, show you what it wrote down before it starts, check the
+   result with you, and file it when you accept.
+
+## File map
+
+- `.agents/skills/` — the six skills of `general` mode: `atw-interview`,
+  `atw-research`, `atw-session-insight`, `atw-noob-mode`, `atw-askme`,
+  `atw-handoff`.
+- `.dsh/skills/` — the dsh-private entry skill `atw-start`.
+- `.atw/` — tasks, the conventions file (`.atw/spec/conventions.md`),
+  workspace memory, and the shared scripts the skills invoke
+  (`get_context.py`, `task.py`, ...).
+
+{{/MODE_GENERAL}}
 ## Notes
 
 - Skill scripts pass `--platform dsh` to `get_context.py`; the value is used
@@ -51,6 +92,8 @@ In dsh:
 - The shipped `minimal` agent preset composes only `bash` +
   `str_replace_editor`; the default presets include `web_search` and the
   filesystem/terminal tools the skills assume.
+{{^MODE_GENERAL}}
 - dsh has no project-level sub-agent definition surface, so ATW ships no
   `atw-implement-agent` / `atw-review` agent prompts
   here — the workflow skills run those phases inline in the main session.
+{{/MODE_GENERAL}}

package/dist/templates/markdown/agents.md

@@ -5,16 +5,27 @@ These instructions are for AI assistants working in this project.
 
 This project is managed by ATW. The working knowledge you need lives under `.atw/`:
 
+{{^MODE_GENERAL}}
 - `.atw/workflow.md` — development phases, when to create tasks, skill routing
 - `.atw/spec/` — package- and layer-scoped coding guidelines (read before writing code in a given layer)
+{{/MODE_GENERAL}}
+{{#MODE_GENERAL}}
+- `.atw/workflow.md` — how work goes here: when to keep a task, what to write down for the user to confirm, how to check and file the result
+- `.atw/spec/conventions.md` — what the user asked for more than once (follow it in every reply; add to it when they correct you)
+{{/MODE_GENERAL}}
 - `.atw/workspace/` — per-developer journals and session traces
 - `.atw/tasks/` — active and archived tasks (PRDs, research, jsonl context)
 
+{{^MODE_GENERAL}}
 ATW commands are written by bare name throughout `.atw/` — `start`, `continue`, `finish-work`. The prefix that invokes them is your platform's, not ATW's: Claude Code uses `/atw:`, Cursor and Pi `/atw-`, Codex `$`, Copilot a plain `/`, and a few hosts expose them as skills instead. Prefer an available ATW command over manual steps; not every platform exposes every command.
 
 If you're using Codex or another agent-capable tool, additional project-scoped helpers may live in:
 - `.agents/skills/` — reusable ATW skills
 - `.codex/agents/` — optional custom subagents
+{{/MODE_GENERAL}}
+{{#MODE_GENERAL}}
+The user moves the work along by saying what they want, not by running ATW commands: you create, advance and archive tasks yourself, as the workflow says. The one ATW command is `start`, which loads this context on platforms that do not load it when a session begins; the prefix that invokes it is your platform's, not ATW's.
+{{/MODE_GENERAL}}
 
 Managed by ATW. Edits outside this block are preserved; edits inside may be overwritten by a future `atw update`.
 

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

@@ -4,6 +4,14 @@
  * These are GENERIC templates for new projects.
  * Structure templates use .md.txt extension as they are generic templates.
  */
+import type { ProjectMode } from "../../utils/project-mode.js";
+/**
+ * 某个项目模式的根 `AGENTS.md`，即该模式下这个文件的 ATW 原版内容。
+ *
+ * 初始化、升级和模式切换都从这里取，所以三处给出的是同一份。
+ */
+export declare function agentsMdFor(mode: ProjectMode): string;
+/** dev 项目（以及没有模式配置项的老项目）的 `AGENTS.md`。 */
 export declare const agentsMdContent: string;
 export declare const workspaceIndexContent: string;
 export declare const agentProgressIndexContent: string;
@@ -25,4 +33,5 @@ export declare const frontendDesignSystemContent: string;
 export declare const guidesIndexContent: string;
 export declare const guidesCrossLayerThinkingGuideContent: string;
 export declare const guidesCodeReuseThinkingGuideContent: string;
+export declare const conventionsContent: 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;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAmB/D;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAErD;AAED,0CAA0C;AAC1C,eAAO,MAAM,eAAe,EAAE,MAA2B,CAAC;AAG1D,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;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC"}

package/dist/templates/markdown/index.js

@@ -7,6 +7,7 @@
 import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { resolveModeBlocks } from "../../configurators/shared.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /**
@@ -19,7 +20,17 @@ function readLocalTemplate(filename) {
 // =============================================================================
 // Root files for new projects
 // =============================================================================
-export const agentsMdContent = readLocalTemplate("agents.md");
+const agentsMdTemplate = readLocalTemplate("agents.md");
+/**
+ * 某个项目模式的根 `AGENTS.md`，即该模式下这个文件的 ATW 原版内容。
+ *
+ * 初始化、升级和模式切换都从这里取，所以三处给出的是同一份。
+ */
+export function agentsMdFor(mode) {
+    return resolveModeBlocks(agentsMdTemplate, mode);
+}
+/** dev 项目（以及没有模式配置项的老项目）的 `AGENTS.md`。 */
+export const agentsMdContent = agentsMdFor("dev");
 // Workspace index template (developer work records)
 export const workspaceIndexContent = readLocalTemplate("workspace-index.md");
 // Backwards compatibility alias
@@ -50,4 +61,6 @@ export const frontendDesignSystemContent = readLocalTemplate("spec/frontend/desi
 export const guidesIndexContent = readLocalTemplate("spec/guides/index.md.txt");
 export const guidesCrossLayerThinkingGuideContent = readLocalTemplate("spec/guides/cross-layer-thinking-guide.md.txt");
 export const guidesCodeReuseThinkingGuideContent = readLocalTemplate("spec/guides/code-reuse-thinking-guide.md.txt");
+// general 项目的约定位置：一个平铺的文件，不分包、不分层
+export const conventionsContent = readLocalTemplate("spec/conventions.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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;GAEG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF,MAAM,CAAC,MAAM,eAAe,GAAW,iBAAiB,CAAC,WAAW,CAAC,CAAC;AAEtE,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAChC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;AAE1C,gCAAgC;AAChC,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAE/D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,wBAAwB,GACnC,iBAAiB,CAAC,eAAe,CAAC,CAAC;AAErC,gFAAgF;AAChF,0DAA0D;AAC1D,wEAAwE;AACxE,gFAAgF;AAEhF,uCAAuC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAW,iBAAiB,CAC1D,2BAA2B,CAC5B,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAW,iBAAiB,CACvE,yCAAyC,CAC1C,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAW,iBAAiB,CACvE,yCAAyC,CAC1C,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAW,iBAAiB,CACtE,wCAAwC,CACzC,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAW,iBAAiB,CACtE,wCAAwC,CACzC,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAW,iBAAiB,CAClE,oCAAoC,CACrC,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAW,iBAAiB,CAC3D,4BAA4B,CAC7B,CAAC;AACF,MAAM,CAAC,MAAM,iCAAiC,GAAW,iBAAiB,CACxE,0CAA0C,CAC3C,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAW,iBAAiB,CAChE,kCAAkC,CACnC,CAAC;AACF,MAAM,CAAC,MAAM,6BAA6B,GAAW,iBAAiB,CACpE,sCAAsC,CACvC,CAAC;AACF,MAAM,CAAC,MAAM,kCAAkC,GAAW,iBAAiB,CACzE,2CAA2C,CAC5C,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAW,iBAAiB,CACvE,yCAAyC,CAC1C,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAW,iBAAiB,CACrE,uCAAuC,CACxC,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAW,iBAAiB,CAClE,oCAAoC,CACrC,CAAC;AAEF,mBAAmB;AACnB,MAAM,CAAC,MAAM,kBAAkB,GAAW,iBAAiB,CACzD,0BAA0B,CAC3B,CAAC;AACF,MAAM,CAAC,MAAM,oCAAoC,GAAW,iBAAiB,CAC3E,+CAA+C,CAChD,CAAC;AACF,MAAM,CAAC,MAAM,mCAAmC,GAAW,iBAAiB,CAC1E,8CAA8C,CAC/C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"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"}

package/dist/templates/markdown/spec/conventions.md.txt

@@ -0,0 +1,13 @@
+# 约定 / Conventions
+
+这个项目的使用者不止一次提过的要求：东西要怎么写、怎么起名、怎么排版、怎么检查，以及不想要什么。AI 每次开始对话都会先读这个文件，并照着做。
+
+AI 自己也会往里记。你纠正了它，或者把某个要求又说了一遍，它就在这里记下一行，这样同样的话不用说第二遍。哪一条不再适用了，你可以自己改掉或删掉。
+
+What the user of this project has asked for more than once: how they want things written, named, laid out or checked, and what they do not want. The AI reads this file at the start of every session and follows it.
+
+The AI adds to it as well. When the user corrects it, or repeats a preference, it writes that down here as one short line, so nobody has to say it again. Edit or delete any line yourself once it stops being true.
+
+## 说定的事 / What we agreed
+
+（还没有。/ Nothing yet.）

package/dist/templates/opencode/lib/atw-context.js

@@ -144,6 +144,25 @@ function unquoteYaml(s) {
   return s
 }
 
+/**
+ * Whether the project is in `general` mode. Mirrors
+ * `common.config.get_project_mode()`: a top-level `mode:` key in
+ * .atw/config.yaml; a missing key or any other value is `dev`.
+ */
+export function isGeneralProject(directory) {
+  let text
+  try {
+    text = readFileSync(join(directory, ".atw", "config.yaml"), "utf-8")
+  } catch {
+    return false
+  }
+  for (const line of text.split(/\r?\n/)) {
+    const m = line.match(/^mode\s*:\s*(.*)$/)
+    if (m) return unquoteYaml(stripInlineComment(m[1]).trim()) === "general"
+  }
+  return false
+}
+
 /**
  * Line-based parser for ONLY the `context_injection:` block of
  * `.atw/config.yaml`. Not a general YAML parser — mirrors