@chinhae/atw-cli 0.3.6 → 0.5.0

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

package/dist/templates/opencode/lib/session-utils.js

@@ -3,7 +3,7 @@ import { existsSync, readFileSync, readdirSync, statSync } from "fs"
 import { join } from "path"
 import { execFileSync } from "child_process"
 import { platform } from "os"
-import { debugLog } from "./atw-context.js"
+import { debugLog, isGeneralProject } from "./atw-context.js"
 
 const PYTHON_CMD = platform() === "win32" ? "python" : "python3"
 
@@ -18,10 +18,22 @@ The acknowledgment must not alter the language used for the remainder of the res
 This notice is one-shot: do not repeat it after the first visible assistant reply in this session.
 </first-reply-notice>`
 
-function getTaskStatus(ctx, platformInput = null) {
+/**
+ * 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 — keep the wording in step
+ * with `_get_task_status` in the shared session-start hook.
+ */
+function getTaskStatus(ctx, platformInput = null, general = false) {
   const active = ctx.getActiveTask(platformInput)
   const taskRef = active.taskPath
   if (!taskRef) {
+    if (general) {
+      return (
+        "Status: NO ACTIVE TASK\n" +
+        "Next-Action: Do what <atw-workflow> above says for a session with no current task."
+      )
+    }
     return (
       "Status: NO ACTIVE TASK\n" +
       "Next-Action: Classify the current turn before creating any ATW task. " +
@@ -50,6 +62,11 @@ function getTaskStatus(ctx, platformInput = null) {
   const taskStatus = taskData.status || "unknown"
 
   if (taskStatus === "completed") {
+    if (general) {
+      // A general task records no branch; without the switch the archive is
+      // refused in a repository that has a remote.
+      return `Status: COMPLETED\nTask: ${taskTitle}\nNext-Action: The archive was interrupted — re-run \`task.py archive <task> --skip-branch-validation\` to finish it.`
+    }
     return `Status: COMPLETED\nTask: ${taskTitle}\nNext-Action: The archive was interrupted — re-run \`task.py archive <task>\` to finish it. If the working tree is dirty, commit or set the task back to \`implement\` first; there is no wrap-up commit step.`
   }
 
@@ -253,11 +270,16 @@ function buildCompactCurrentState(ctx, platformInput, specIndexPaths) {
   const lines = []
   lines.push(`Developer: ${readDeveloper(directory)}`)
 
-  const branch = runGit(directory, ["branch", "--show-current"]) || "(detached)"
-  const dirtyCount = runGit(directory, ["status", "--porcelain"])
-    .split(/\r?\n/)
-    .filter(line => line.trim()).length
-  lines.push(`Git: branch ${branch}; ${dirtyCount === 0 ? "clean" : `dirty ${dirtyCount} paths`}.`)
+  // 普通文件夹没有分支，也谈不上干净：照实说，不编一个状态出来。
+  if (runGit(directory, ["rev-parse", "--is-inside-work-tree"]) !== "true") {
+    lines.push("Git: not a git repository.")
+  } else {
+    const branch = runGit(directory, ["branch", "--show-current"]) || "(detached)"
+    const dirtyCount = runGit(directory, ["status", "--porcelain"])
+      .split(/\r?\n/)
+      .filter(line => line.trim()).length
+    lines.push(`Git: branch ${branch}; ${dirtyCount === 0 ? "clean" : `dirty ${dirtyCount} paths`}.`)
+  }
 
   const active = ctx.getActiveTask(platformInput)
   if (active.taskPath) {
@@ -312,6 +334,32 @@ function buildCompactCurrentState(ctx, platformInput, specIndexPaths) {
   return lines.join("\n")
 }
 
+const CONVENTIONS_PATH = ".atw/spec/conventions.md"
+
+/**
+ * The <conventions> block of a `general` project, else "". Mirrors
+ * conventions_context() in .atw/scripts/common/session_context.py — keep the two
+ * in step: a general project has one flat conventions file instead of
+ * per-package, per-layer guideline indexes, and always gets the block, so the
+ * AI knows where the first entry goes.
+ */
+function buildConventionsContext(directory) {
+  if (!isGeneralProject(directory)) return ""
+  const header =
+    `Source: ${CONVENTIONS_PATH} — what this project's user asked for more than ` +
+    "once. Follow it in every reply."
+  let body = ""
+  try {
+    body = readFileSync(join(directory, CONVENTIONS_PATH), "utf-8").trim()
+  } catch {
+    // Not written yet.
+  }
+  if (!body) {
+    return `<conventions>\n${header} Nothing is written there yet.\n</conventions>`
+  }
+  return `<conventions>\n${header}\n\n${body}\n</conventions>`
+}
+
 export function buildSessionContext(ctx, platformInput = null) {
   const directory = ctx.directory
   const contextKey = typeof ctx.getContextKey === "function"
@@ -320,7 +368,10 @@ export function buildSessionContext(ctx, platformInput = null) {
 
   const config = loadAtwConfig(directory, contextKey)
   const allowedPkgs = resolveSpecScope(config)
-  const paths = collectSpecIndexPaths(directory, allowedPkgs)
+  // A general project keeps no guideline indexes — whatever a switch from dev
+  // left under `.atw/spec/` is not offered there.
+  const conventions = buildConventionsContext(directory)
+  const paths = conventions ? [] : collectSpecIndexPaths(directory, allowedPkgs)
 
   const parts = []
 
@@ -374,26 +425,30 @@ ATW compact SessionStart context. Use it to orient the session; load details on
     parts.push("</atw-workflow>")
   }
 
-  parts.push("<guidelines>")
-  parts.push(
-    "Task context order for implementation/check: jsonl entries -> `prd.md`.\n"
-  )
+  if (conventions) {
+    parts.push(conventions)
+  } else {
+    parts.push("<guidelines>")
+    parts.push(
+      "Task context order for implementation/check: jsonl entries -> `prd.md`.\n"
+    )
 
-  if (paths.length > 0) {
-    parts.push("## Available indexes (read on demand)")
-    for (const p of paths) {
-      parts.push(`- ${p}`)
+    if (paths.length > 0) {
+      parts.push("## Available indexes (read on demand)")
+      for (const p of paths) {
+        parts.push(`- ${p}`)
+      }
+      parts.push("")
     }
-    parts.push("")
-  }
 
-  parts.push(
-    "Discover more via: " +
-    "`python3 ./.atw/scripts/get_context.py --mode packages`"
-  )
-  parts.push("</guidelines>")
+    parts.push(
+      "Discover more via: " +
+      "`python3 ./.atw/scripts/get_context.py --mode packages`"
+    )
+    parts.push("</guidelines>")
+  }
 
-  const taskStatus = getTaskStatus(ctx, platformInput)
+  const taskStatus = getTaskStatus(ctx, platformInput, Boolean(conventions))
   parts.push(`<task-status>\n${taskStatus}\n</task-status>`)
 
   parts.push(`<ready>

package/dist/templates/opencode/plugins/inject-workflow-state.js

@@ -29,7 +29,12 @@ import {
   platformInputFromMessages,
   prependEphemeralText,
 } from "../lib/context-visibility.js"
-import { AtwContext, debugLog, isAtwSubagent } from "../lib/atw-context.js"
+import {
+  AtwContext,
+  debugLog,
+  isAtwSubagent,
+  isGeneralProject,
+} from "../lib/atw-context.js"
 
 // Supports STATUS values with letters, digits, underscores, hyphens
 // (so "in-review" / "blocked-by-team" work alongside "task_error").
@@ -177,18 +182,23 @@ const NOOB_MODE_FALLBACK =
   "language, and every term, command or path explained where it appears."
 
 /**
- * The <noob-mode> block for a developer who switched noob mode on, else "".
- * Mirrors noob_mode_reminder() in .atw/scripts/common/noob_mode.py: the
- * switch is a `noob_mode=on` line in the gitignored .atw/.developer.
+ * The <noob-mode> block while noob mode is on for this developer, else "".
+ * Mirrors is_noob_mode_on() / noob_mode_reminder() in
+ * .atw/scripts/common/noob_mode.py — keep the two in step: a `noob_mode=on`
+ * or `noob_mode=off` line in the gitignored .atw/.developer is the
+ * developer's own choice and wins; without one the project mode decides
+ * (on for `general`, off for `dev`).
  */
 function buildNoobModeReminder(directory, templates) {
-  let developer
+  let choice = null
   try {
-    developer = readFileSync(join(directory, ".atw", ".developer"), "utf-8")
+    const developer = readFileSync(join(directory, ".atw", ".developer"), "utf-8")
+    const m = developer.match(/^noob_mode=(.*)$/m)
+    if (m) choice = m[1].trim() === "on"
   } catch {
-    return ""
+    // No identity file: this developer never chose.
   }
-  if (!/^noob_mode=on\s*$/m.test(developer)) return ""
+  if (!(choice ?? isGeneralProject(directory))) return ""
   return `<noob-mode>\n${templates.noob_mode || NOOB_MODE_FALLBACK}\n</noob-mode>`
 }
 

package/dist/templates/pi/extensions/atw/index.ts.txt

@@ -1249,18 +1249,24 @@ function buildStartupContext(
   overview: string,
 ): string {
   const workflow = workflowOverview(root, key);
+  // get_context.py puts a <conventions> block in the overview only for a
+  // `general` project. Its workflow has its own way to pick up unfinished
+  // work; the bare `task.py start` below is one the script refuses there.
+  const ready = overview.includes("\n<conventions>\n")
+    ? [
+        "Do what <atw-workflow> above says for the current task's status. With no current task, it also says when to create one and how to pick up unfinished work.",
+      ]
+    : [
+        "Use the current workflow state to decide whether to create, continue, or skip an ATW task.",
+        "When CURRENT TASK is (none) but ACTIVE TASKS lists exactly one task assigned to you that is already at the implement or accept stage, this window is merely not bound to it yet: run `python3 ./.atw/scripts/task.py start <task-dir>` for that task, then continue from its stage. Do not ask whether to create a new task in that case.",
+        "If several tasks qualify, or the only candidate is still in a planning stage (discover / specify / slice), ask which task to bind instead of running start: start moves a planning-stage task straight into implement.",
+      ];
   return [
     "<session-context>\nATW compact SessionStart context. Use it to orient the session; load details on demand.\n</session-context>",
     FIRST_REPLY_NOTICE,
     overview,
     workflow,
-    [
-      "<ready>",
-      "Use the current workflow state to decide whether to create, continue, or skip an ATW task.",
-      "When CURRENT TASK is (none) but ACTIVE TASKS lists exactly one task assigned to you that is already at the implement or accept stage, this window is merely not bound to it yet: run `python3 ./.atw/scripts/task.py start <task-dir>` for that task, then continue from its stage. Do not ask whether to create a new task in that case.",
-      "If several tasks qualify, or the only candidate is still in a planning stage (discover / specify / slice), ask which task to bind instead of running start: start moves a planning-stage task straight into implement.",
-      "</ready>",
-    ].join("\n"),
+    ["<ready>", ...ready, "</ready>"].join("\n"),
   ]
     .filter(Boolean)
     .join("\n\n");
@@ -1983,9 +1989,14 @@ export default function atwExtension(pi: {
   // Events
   pi.on?.("session_start", (event, ctx) => {
     const k = getKey(event, ctx);
-    inheritSessionPointer(resolveRoot(ctx), k, event);
+    const root = resolveRoot(ctx);
+    inheritSessionPointer(root, k, event);
+    // A `general` project installs no /atw-continue prompt.
+    const canContinue = exists(join(root, ".pi", "prompts", "atw-continue.md"));
     ctx?.ui?.notify?.(
-      "ATW project context is available. Use /atw-start to bootstrap or /atw-continue to resume.",
+      canContinue
+        ? "ATW project context is available. Use /atw-start to bootstrap or /atw-continue to resume."
+        : "ATW project context is available. Use /atw-start to bootstrap.",
       "info",
     );
   });