@pennixrv/trellis 0.7.1-beta.9 → 0.7.2-beta.0

package/dist/templates/common/bundled-skills/trellis-teamwork/references/teamwork-plan-construction.md

@@ -14,10 +14,14 @@ coordination_mode
 ```
 
 The plan also freezes the Teamwork Session, batch, deadline, protected targets,
-and ordered `assignments`. Each assignment has an `assignment_id`, brief path,
-role, provider, optional profile and model, scope, lens, source digest,
-acceptance criteria, and an explicit retry budget. The CLI validates the plan
-and the immutable brief before dispatch.
+and ordered `assignments`. Each assignment has an `assignment_id`, selected
+profile/configuration, selection reason, task input, scope, optional lens,
+source digest, acceptance criteria, and an explicit retry budget. The native
+constructor resolves the effective provider/model/effort/options and common
+plus professional instructions, then publishes schema-2 plan and briefs.
+Claims also use schema 2; new launches freeze `reportVersion: 2`. Historical
+frozen launches without it continue to read schema-1 reports. Do not hand-author frozen
+execution objects, role or capability digests, claims, or plan hashes.
 
 Use the native task lifecycle for task status and acceptance. Teamwork records
 coordination facts and teammate reports; it does not write `current_phase_id`,
@@ -39,19 +43,78 @@ specs, and the generic teammate role card. Freeze the input revision and route
 revision after the coordinator has selected the scope. If those values change,
 construct a new plan rather than mixing results from different task inputs.
 
-The reserved managed-batch entry point is:
+Construct and run through the native entry points:
 
 ```bash
-trellis teamwork batch <plan-path>
+trellis teamwork config --profile review --mode advisor
+trellis teamwork plan <draft.json> --task <task-dir> --output <task-dir>/plan.json --dry-run
+trellis teamwork plan <draft.json> --task <task-dir> --output <task-dir>/plan.json
+trellis teamwork batch <task-dir>/plan.json --task <task-dir> --preflight
+trellis teamwork batch <task-dir>/plan.json --task <task-dir> --json
 ```
 
-The current CLI unconditionally refuses this command before writing
-coordination state: a verified runtime adapter has not been connected to the
-coordinator. It does not discover an adapter or start the batch. The shared
-coordinator and its plan/report contracts exist and are tested separately.
-Do not present `run` or `spawn` as a substitute for managed batch execution.
-When connected, the coordinator owns dispatch, waiting, report acceptance,
-and the terminal receipt; the coordinating agent must not add a second retry loop.
+The draft is a JSON object with `schema_version: 2`, the binding fields above,
+safe `batch_id` and `session_id`, `deadline`, optional `requested_capacity`
+and `protected_targets`, and explicit `assignments`. A minimal member is:
+
+```json
+{
+  "assignment_id": "review-a",
+  "profile": "review",
+  "configuration": "codex-sol",
+  "selection_reason": "Use the configured source reviewer",
+  "summary": "Review the selected change",
+  "scope": "src/example.ts",
+  "input": "Inspect the assigned source and return evidence in the requested report.",
+  "source_digest": "<SHA-256 of the selected source evidence>",
+  "acceptance": ["Cite precise source locations and explain observable impact"],
+  "max_retries": 0
+}
+```
+
+Optional member overrides are `provider`, `model`, `reasoning_effort`, and
+adapter-supported `options`; context comes from `context_files` and
+`context_manifests`. Committee members additionally need distinct `lens`
+values and otherwise share the same task/evidence/acceptance contract. The
+constructor creates their evaluation group. Read the configuration matrix
+before choosing candidates. Output must be inside the selected task under
+this project's `.trellis/tasks/`; existing immutable artifacts are preserved.
+
+`--dry-run` validates all prepared briefs and paths without writing artifacts.
+`--preflight` validates frozen inputs, current native task revisions and
+capacity without launching a provider; `processProbe: not_run` means accounts,
+models and transport have not been tested by that command. Actual dispatch
+negotiates provider model and effort and fails explicitly if unsupported.
+
+Invoke one foreground `trellis teamwork batch` command and wait for its
+receipt. The CLI owns FIFO admission, capacity, provider waits, retries,
+cancellation, report acceptance, and settlement. The main agent does not
+schedule per-assignment waits or retries. A timeout continuation waits on the
+same provider process under the frozen batch deadline; it does not send another
+provider prompt or consume a full-attempt retry. At the batch deadline, the CLI
+closes admission, marks undispatched FIFO work `FINAL_FAILED`, then cancels and
+drains active attempts. Confirmed outcomes settle as `SETTLED_WITH_FAILURE`;
+unconfirmed process exit requires reconciliation.
+
+A valid `blocked` report with evidence ends only that assignment as
+`FINAL_FAILED`; the CLI continues with the remaining FIFO work and preserves
+the blocker report. Missing reports may use the assignment's declared retry
+budget. A truncated report or report storage error is uncertain and requires
+reconciliation. Other incomplete or rejected reports may retry only within the
+declared attempt budget.
+
+`run` and `spawn` operate interactive sessions and do not bypass batch
+reconciliation. A restart returns a durable terminal receipt or
+`RECONCILIATION_REQUIRED`; it never silently replays an uncertain attempt.
+Before returning a recovered terminal receipt, the CLI checks the frozen plan,
+all assignment dispositions, terminal attempt and teammate facts, capacity
+leases, projection issues, and the exact receipt event. It may reconstruct a
+missing receipt only from consistent terminal facts. Capacity reservations
+survive a coordinator crash because a dead coordinator does not prove its
+provider processes exited. Do not delete an unresolved reservation to make
+another batch fit; inspect ownership and terminal evidence. An unreadable or
+conflicting recovery state retains the reservation and original evidence; it
+does not authorize a replacement dispatch.
 
 ## Teamwork Session and forum commands
 
@@ -59,10 +122,10 @@ Create and inspect the durable runtime object with the native CLI:
 
 ```bash
 trellis teamwork create <name> --type chat|forum \
-  --task .trellis/tasks/<task-dir> --description "bounded discussion"
+  --task .trellis/tasks/in_progress/<task-dir> --description "bounded discussion"
 trellis teamwork list [--scope project|global] [--all]
 trellis teamwork messages <name> [--raw]
-trellis teamwork wait <name> --as <agent> --kind done,turn_finished
+trellis teamwork wait <name> --as <agent> --from <worker> --json
 trellis teamwork forum <name>
 trellis teamwork thread <name> <thread-key>
 trellis teamwork context list <name> [--thread <thread-key>]
@@ -110,9 +173,38 @@ archive operation.
 
 ## Result handling
 
+Agent callers always request the machine view: `run --json`, `batch --json`,
+or interactive `wait --json --from <one-worker>`. The common envelope has
+`schemaVersion: 1`, `kind: trellis_result`, `mode`, `association`, `execution`,
+`reports`, `semanticValidation: not_run`, and `disposition`. Execution facts
+are distinct from report validation, model content status, and task acceptance.
+`execution.stopped` describes confirmed process cleanup; a persistent wait
+leaves its worker running. Parse stdout as one JSON object; diagnostics use
+stderr. CLI argument-parser errors may precede this result contract.
+
+Each new content report has `schema_version: 2`, `status` (complete, blocked,
+incomplete, error), nonempty `answer`, nonempty `evidence` entries with
+`id`, `locator`, `summary`, and arrays `limitations`, `unresolved`, `deviations`.
+Interactive replies return this JSON directly, with no report file or invented
+batch identity. Batch reports additionally copy the assigned task, batch,
+assignment, attempt, teammate, plan, phase, route, input and source identities
+into the exact report path. `done` is emitted by the adapter, not by the model.
+
+Batch machine results expose validated report content, association, report path
+and SHA-256. Missing or invalid accepted artifacts fail validation; historical
+schema-1 content is explicitly `legacy`, never synthesized as a valid new
+answer. Retention may remove failed-attempt artifacts. Main-agent semantic
+review checks the answer and evidence against the acceptance criteria; shape
+validation does not perform that review or change native task acceptance.
+
 The coordinator returns `ALL_ACCEPTED`, `SETTLED_WITH_FAILURE`, or
-`RECONCILIATION_REQUIRED`. A terminal receipt is a runtime fact. The main task
-then reviews reports against the phase contract, records durable evidence in
-the task-owned artifact, and uses the task's native acceptance gate before
-advancing. A formal session handoff is an independent, lower-priority
-continuity artifact and does not represent a phase transition.
+`RECONCILIATION_REQUIRED`. For `ALL_ACCEPTED`, review every accepted report
+against the phase contract, record the evidence in the task-owned artifact, and
+use the native task acceptance gate before advancing. For
+`SETTLED_WITH_FAILURE`, review the failure reports and blockers, do not accept
+or advance the phase, and decide the next task-level action through the native
+workflow. For `RECONCILIATION_REQUIRED`, stop dispatch, retry, and cleanup;
+preserve the reported runtime evidence and reservation for explicit
+reconciliation. A receipt is a runtime fact, not phase acceptance. A formal
+session handoff is an independent, lower-priority continuity artifact and does
+not represent a phase transition.

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

@@ -231,8 +231,7 @@ def _get_task_status(trellis_dir: Path, hook_input: dict) -> str:
     if not active.task_path:
         return (
             "Status: NO ACTIVE TASK\n"
-            "Next: Classify the current turn and ask for task-creation consent "
-            "before creating any Trellis task."
+            "Next: Route through trellis-request-intake using the existing authorization and taskless contract."
         )
 
     task_ref = active.task_path
@@ -244,12 +243,10 @@ def _get_task_status(trellis_dir: Path, hook_input: dict) -> str:
         )
 
     task_json_path = task_dir / "task.json"
-    task_data: dict = {}
-    if task_json_path.is_file():
-        try:
-            task_data = json.loads(task_json_path.read_text(encoding="utf-8"))
-        except (json.JSONDecodeError, PermissionError):
-            pass  # Optional task metadata; fall back to generic status.
+    from common.io import read_json_checked  # type: ignore[import-not-found]
+    task_data, _reason = read_json_checked(task_json_path)
+    if task_data is None or task_data.get("status") not in ("planning", "in_progress", "completed", "cancelled"):
+        return f"Status: TASK_ERROR\nTask: {task_ref}\nNext: Repair the existing task record through its owner before continuing; do not create a replacement task."
 
     task_title = task_data.get("title", task_ref)
     task_status = task_data.get("status", "unknown")
@@ -379,13 +376,15 @@ def _build_compact_current_state(
     active = _resolve_active_task(trellis_dir, hook_input)
     if active.task_path:
         task_dir = _resolve_task_dir(trellis_dir, active.task_path)
-        status = "unknown"
+        status = "task_error"
         task_json = task_dir / "task.json"
         if task_json.is_file():
             try:
                 data = json.loads(task_json.read_text(encoding="utf-8"))
                 if isinstance(data, dict):
-                    status = str(data.get("status") or "unknown")
+                    value = data.get("status")
+                    if value in ("planning", "in_progress", "completed", "cancelled"):
+                        status = value
             except (json.JSONDecodeError, OSError):
                 pass  # Optional task metadata; fall back to generic status.
         lines.append(f"Current task: {_repo_relative(repo_root, task_dir)}; status={status}.")
@@ -503,11 +502,15 @@ def main() -> None:
         hook_input = json.loads(sys.stdin.read())
         if not isinstance(hook_input, dict):
             hook_input = {}
-        project_dir = Path(_normalize_windows_shell_path(hook_input.get("cwd", "."))).resolve()
+        raw_cwd = hook_input.get("cwd")
+        project_dir = Path(_normalize_windows_shell_path(raw_cwd if isinstance(raw_cwd, str) and raw_cwd else ".")).resolve()
     except (json.JSONDecodeError, KeyError):
         hook_input = {}
         project_dir = Path(".").resolve()
 
+    project_dir = next((candidate for candidate in (project_dir, *project_dir.parents) if (candidate / ".trellis").is_dir()), None)
+    if project_dir is None or not (project_dir / ".trellis" / "scripts" / "common" / "active_task.py").is_file():
+        return
     configure_project_encoding(project_dir)
 
     trellis_dir = project_dir / ".trellis"

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

@@ -5,7 +5,7 @@
  *
  * Directory structure:
  *   copilot/
- *   ├── prompts/         # Slash-command prompts → .github/prompts/*.prompt.md
+ *   Slash-command prompts come from common/commands via the configurator.
  *   ├── hooks/           # Hook scripts → .github/copilot/hooks/
  *   ├── hooks.json       # Hooks config → .github/hooks/trellis.json
  *   └── copilot-instructions.md → .github/copilot-instructions.md
@@ -17,12 +17,7 @@ export interface HookTemplate {
     name: string;
     content: string;
 }
-export interface PromptTemplate {
-    name: string;
-    content: string;
-}
 export declare function getAllHooks(): HookTemplate[];
 export declare function getHooksConfig(): string;
 export declare function getCopilotInstructions(): string;
-export declare function getAllPrompts(): PromptTemplate[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,eAAO,MAAM,gCAAgC,4CACF,CAAC;AAC5C,eAAO,MAAM,8BAA8B,0CACF,CAAC;AAc1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAW5C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,aAAa,IAAI,cAAc,EAAE,CAchD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,eAAO,MAAM,gCAAgC,4CACF,CAAC;AAC5C,eAAO,MAAM,8BAA8B,0CACF,CAAC;AAc1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAW5C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}

package/dist/templates/copilot/index.js

@@ -5,7 +5,7 @@
  *
  * Directory structure:
  *   copilot/
- *   ├── prompts/         # Slash-command prompts → .github/prompts/*.prompt.md
+ *   Slash-command prompts come from common/commands via the configurator.
  *   ├── hooks/           # Hook scripts → .github/copilot/hooks/
  *   ├── hooks.json       # Hooks config → .github/hooks/trellis.json
  *   └── copilot-instructions.md → .github/copilot-instructions.md
@@ -45,17 +45,4 @@ export function getHooksConfig() {
 export function getCopilotInstructions() {
     return readTemplate("copilot-instructions.md");
 }
-export function getAllPrompts() {
-    const prompts = [];
-    for (const file of listFiles("prompts")) {
-        if (!file.endsWith(".prompt.md")) {
-            continue;
-        }
-        prompts.push({
-            name: file.slice(0, -".prompt.md".length),
-            content: readTemplate(`prompts/${file}`),
-        });
-    }
-    return prompts;
-}
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,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,MAAM,CAAC,MAAM,yBAAyB,GAAG,iCAAiC,CAAC;AAC3E,MAAM,CAAC,MAAM,gCAAgC,GAC3C,yCAAyC,CAAC;AAC5C,MAAM,CAAC,MAAM,8BAA8B,GACzC,uCAAuC,CAAC;AAE1C,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAYD,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,YAAY,CAAC,yBAAyB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;YACzC,OAAO,EAAE,YAAY,CAAC,WAAW,IAAI,EAAE,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,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,MAAM,CAAC,MAAM,yBAAyB,GAAG,iCAAiC,CAAC;AAC3E,MAAM,CAAC,MAAM,gCAAgC,GAC3C,yCAAyC,CAAC;AAC5C,MAAM,CAAC,MAAM,8BAA8B,GACzC,uCAAuC,CAAC;AAE1C,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAOD,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,YAAY,CAAC,yBAAyB,CAAC,CAAC;AACjD,CAAC"}

package/dist/templates/markdown/spec/backend/index.md.txt

@@ -1,38 +1,7 @@
-# Backend Development Guidelines
+# 后端开发规范索引
 
-> Best practices for backend development in this project.
+此文件是项目规范的入口，尚未建立源码约定。
 
----
+在首次实施前使用 `trellis-spec-bootstrap`，核对本项目实际源码、包边界和验证入口，只建立适用且有证据的规范，并在这里添加链接。不要把通用建议、未核实的技术栈或占位内容当作项目合同；没有数据库时不创建数据库规范。
 
-## Overview
-
-This directory contains guidelines for backend development. Fill in each file with your project's specific conventions.
-
----
-
-## Guidelines Index
-
-| Guide | Description | Status |
-|-------|-------------|--------|
-| [Directory Structure](./directory-structure.md) | Module organization and file layout | To fill |
-| [Database Guidelines](./database-guidelines.md) | ORM patterns, queries, migrations | To fill |
-| [Error Handling](./error-handling.md) | Error types, handling strategies | To fill |
-| [Quality Guidelines](./quality-guidelines.md) | Code standards, forbidden patterns | To fill |
-| [Logging Guidelines](./logging-guidelines.md) | Structured logging, log levels | To fill |
-
----
-
-## How to Fill These Guidelines
-
-For each guideline file:
-
-1. Document your project's **actual conventions** (not ideals)
-2. Include **code examples** from your codebase
-3. List **forbidden patterns** and why
-4. Add **common mistakes** your team has made
-
-The goal is to help AI assistants and new team members understand how YOUR project works.
-
----
-
-**Language**: All documentation should be written in **English**.
+`trellis-before-dev` 按当前修改读取相关规范；`trellis-update-spec` 将已验证、可复用的约定增量写回。保留项目已有的自定义内容和语言要求，不为初始化重写规范。

package/dist/templates/markdown/spec/frontend/index.md.txt

@@ -1,39 +1,7 @@
-# Frontend Development Guidelines
+# 前端开发规范索引
 
-> Best practices for frontend development in this project.
+此文件是项目规范的入口，尚未建立源码约定。
 
----
+在首次实施前使用 `trellis-spec-bootstrap`，核对本项目实际源码、包边界和验证入口，只建立适用且有证据的规范，并在这里添加链接。不要预设框架、状态库、Hook 或组件模式，也不要生成没有源码依据的占位规范。
 
-## Overview
-
-This directory contains guidelines for frontend development. Fill in each file with your project's specific conventions.
-
----
-
-## Guidelines Index
-
-| Guide | Description | Status |
-|-------|-------------|--------|
-| [Directory Structure](./directory-structure.md) | Module organization and file layout | To fill |
-| [Component Guidelines](./component-guidelines.md) | Component patterns, props, composition | To fill |
-| [Hook Guidelines](./hook-guidelines.md) | Custom hooks, data fetching patterns | To fill |
-| [State Management](./state-management.md) | Local state, global state, server state | To fill |
-| [Quality Guidelines](./quality-guidelines.md) | Code standards, forbidden patterns | To fill |
-| [Type Safety](./type-safety.md) | Type patterns, validation | To fill |
-
----
-
-## How to Fill These Guidelines
-
-For each guideline file:
-
-1. Document your project's **actual conventions** (not ideals)
-2. Include **code examples** from your codebase
-3. List **forbidden patterns** and why
-4. Add **common mistakes** your team has made
-
-The goal is to help AI assistants and new team members understand how YOUR project works.
-
----
-
-**Language**: All documentation should be written in **English**.
+`trellis-before-dev` 按当前修改读取相关规范；`trellis-update-spec` 将已验证、可复用的约定增量写回。保留项目已有的自定义内容和语言要求，不为初始化重写规范。

package/dist/templates/omp/extensions/trellis/index.ts.txt

@@ -81,7 +81,7 @@ function parseTeamworkTrustSection(content: string): { trustedDirs: string[]; au
       const trimmed = line.trimEnd();
       if (trimmed.trim().startsWith("#")) continue;
 
-      if (/^channel:\s*$/.test(trimmed)) {
+      if (/^teamwork:\s*$/.test(trimmed)) {
          inChannel = true;
          inList = false;
          continue;

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

@@ -1202,7 +1202,23 @@ function workflowBreadcrumb(root: string, key: string | null): string {
         header = `Task: ${id} (${status})`;
         lookup = status;
       }
-    } catch {}
+      const meta = d.meta as JsonObject | undefined;
+      if (isObj(meta) && "task_workflow" in meta) {
+        const state = meta.task_workflow;
+        const routed = isObj(state) && Array.isArray(state.phase_ids) ? state.phase_ids : [];
+        const phase = isObj(state) && str(state.current_phase_id === null ? routed.at(-1) : state.current_phase_id);
+        const phases = isObj(state) && isObj(state.phases) ? state.phases : null;
+        const record = phase && phases?.[phase];
+        if (phase && isObj(record) && str(record.status)) {
+          lookup = phase;
+          header += `; phase=${phase}; state=${str(record.status) ?? "unknown"}`;
+        } else {
+          lookup = "task_error";
+        }
+      }
+    } catch {
+      lookup = "task_error";
+    }
   }
   const body = templates[lookup] ?? "Refer to workflow.md for current step.";
   return `<workflow-state>\n${header}\n${body}\n</workflow-state>`;

package/dist/templates/shared-hooks/guard-teamwork-wait.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+"""Codex PreToolUse guard for CLI-owned foreground batches.
+
+Only supported host tool hooks are guarded. Ordinary model messages and tools
+that the host does not expose to PreToolUse remain Skill obligations.
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import os
+import shlex
+import sys
+from pathlib import Path
+
+
+def decision(payload: dict) -> dict | None:
+    if not isinstance(payload, dict):
+        return None
+    if os.environ.get("TRELLIS_HOOKS") == "0":
+        return None
+    session = payload.get("session_id") or os.environ.get("CODEX_THREAD_ID")
+    if not isinstance(session, str) or not session:
+        return None
+    root = Path(payload.get("cwd") or os.getcwd()).resolve()
+    while not (root / ".trellis").is_dir() and root != root.parent:
+        root = root.parent
+    directory = root / ".trellis/.runtime/teamwork-waits" / hashlib.sha256(session.encode()).hexdigest()
+    if not directory.exists():
+        return None
+    records = list(directory.glob("*.json"))
+    if not records:
+        return None
+    tool = str(payload.get("tool_name", "")).rsplit(".", 1)[-1]
+    if tool in {"write_stdin", "wait"}:
+        return None
+    tool_input = payload.get("tool_input")
+    tool_input = tool_input if isinstance(tool_input, dict) else {}
+    command = tool_input.get("command", tool_input.get("cmd"))
+    if isinstance(command, str) and not any(character in command for character in "$`;\n&|<>"):
+        try:
+            argv = shlex.split(command)
+        except ValueError:
+            argv = []
+        if argv[:3] == ["trellis", "teamwork", "reconcile"]:
+            return None
+    return {"hookSpecificOutput": {"hookEventName": "PreToolUse", "permissionDecision": "deny", "permissionDecisionReason": "Trellis owns an outstanding foreground batch. Silently continue the original host wait handle, or interrupt that same handle. A dead coordinator still requires native teamwork reconcile; do not start another batch or take over FIFO scheduling."}}
+
+
+if __name__ == "__main__":
+    result = decision(json.load(sys.stdin))
+    if result:
+        print(json.dumps(result))

package/dist/templates/shared-hooks/index.d.ts

@@ -11,7 +11,7 @@ export interface HookScript {
     /** Script content — no placeholders, ready to write directly */
     content: string;
 }
-export type SharedHookName = "session-start.py" | "inject-shell-session-context.py" | "inject-workflow-state.py" | "inject-subagent-context.py" | "inject-spec-context.py";
+export type SharedHookName = "guard-teamwork-wait.py" | "session-start.py" | "inject-shell-session-context.py" | "inject-workflow-state.py" | "inject-subagent-context.py" | "inject-spec-context.py";
 export type SharedHookPlatform = "claude" | "cursor" | "codex" | "opencode" | "gemini" | "qoder" | "copilot" | "codebuddy" | "droid" | "kiro" | "trae" | "zcode";
 /**
  * Which shared hooks each platform actually invokes. Single source of truth

package/dist/templates/shared-hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,iCAAiC,GACjC,0BAA0B,GAC1B,4BAA4B,GAC5B,wBAAwB,CAAC;AAE7B,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,SAAS,GACT,WAAW,GACX,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,kBAAkB,EAClB,SAAS,cAAc,EAAE,CA0D1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,EAAE,CAWnD;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GACtB,wBAAwB,GACxB,kBAAkB,GAClB,iCAAiC,GACjC,0BAA0B,GAC1B,4BAA4B,GAC5B,wBAAwB,CAAC;AAE7B,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,SAAS,GACT,WAAW,GACX,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,kBAAkB,EAClB,SAAS,cAAc,EAAE,CA2D1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,EAAE,CAWnD;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd"}

package/dist/templates/shared-hooks/index.js

@@ -81,6 +81,7 @@ export const SHARED_HOOKS_BY_PLATFORM = {
         "inject-subagent-context.py",
     ],
     codex: [
+        "guard-teamwork-wait.py",
         "inject-workflow-state.py",
         "inject-subagent-context.py",
         "inject-spec-context.py",

package/dist/templates/shared-hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,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,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAGjC;IACF,MAAM,EAAE;QACN,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,wBAAwB;KACzB;IACD,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,4BAA4B;KAC7B;IACD,KAAK,EAAE;QACL,0BAA0B;QAC1B,4BAA4B;QAC5B,wBAAwB;KACzB;IACD,QAAQ,EAAE,CAAC,wBAAwB,CAAC;IACpC,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,OAAO,EAAE,CAAC,0BAA0B,CAAC;IACrC,SAAS,EAAE;QACT,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,IAAI,EAAE;QACJ,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,IAAI,EAAE;QACJ,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAChC,IAAI,EAAE,CAAC;IAEV,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA4B;IAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,OAAO,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,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,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAGjC;IACF,MAAM,EAAE;QACN,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,wBAAwB;KACzB;IACD,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,4BAA4B;KAC7B;IACD,KAAK,EAAE;QACL,wBAAwB;QACxB,0BAA0B;QAC1B,4BAA4B;QAC5B,wBAAwB;KACzB;IACD,QAAQ,EAAE,CAAC,wBAAwB,CAAC;IACpC,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,OAAO,EAAE,CAAC,0BAA0B,CAAC;IACrC,SAAS,EAAE;QACT,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,IAAI,EAAE;QACJ,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,IAAI,EAAE;QACJ,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAChC,IAAI,EAAE,CAAC;IAEV,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA4B;IAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,OAAO,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/templates/shared-hooks/inject-workflow-state.py

@@ -194,8 +194,11 @@ def get_active_task(
     status = data.get("status", "")
     if not isinstance(status, str) or not status:
         return task_dir.name, "task_error", active.source, None
-    phase_workflow = data.get("meta", {}).get("task_workflow") if isinstance(data.get("meta"), dict) else None
-    if isinstance(phase_workflow, dict):
+    meta = data.get("meta")
+    if isinstance(meta, dict) and "task_workflow" in meta:
+        phase_workflow = meta["task_workflow"]
+        if not isinstance(phase_workflow, dict):
+            return task_id, "task_error", active.source, None
         phase_id = phase_workflow.get("current_phase_id")
         phases = phase_workflow.get("phases")
         if phase_id is None:
@@ -204,7 +207,9 @@ def get_active_task(
         phase = phases.get(phase_id) if isinstance(phases, dict) and isinstance(phase_id, str) else None
         if isinstance(phase_id, str) and isinstance(phase, dict):
             phase_status = phase.get("status")
-            return task_id, phase_id, active.source, phase_status if isinstance(phase_status, str) else None
+            if isinstance(phase_status, str) and phase_status:
+                return task_id, phase_id, active.source, phase_status
+        return task_id, "task_error", active.source, None
     return task_id, status, active.source, None
 
 

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

@@ -429,8 +429,7 @@ def _get_task_status(trellis_dir: Path, input_data: dict) -> str:
         return (
             "Status: NO ACTIVE TASK\n"
             "Next-Action: Classify the current turn before creating any Trellis task. "
-            "Simple conversation / small task asks only whether this turn should create a Trellis task. "
-            "Complex task asks whether task creation and planning are allowed."
+            "Route through trellis-request-intake using the existing authorization and taskless contract."
         )
 
     task_ref = active.task_path
@@ -443,12 +442,10 @@ def _get_task_status(trellis_dir: Path, input_data: dict) -> str:
         )
 
     task_json_path = task_dir / "task.json"
-    task_data = {}
-    if task_json_path.is_file():
-        try:
-            task_data = json.loads(task_json_path.read_text(encoding="utf-8"))
-        except (json.JSONDecodeError, PermissionError):
-            pass  # Optional task metadata; fall back to generic status.
+    from common.io import read_json_checked  # type: ignore[import-not-found]
+    task_data, _reason = read_json_checked(task_json_path)
+    if task_data is None or task_data.get("status") not in ("planning", "in_progress", "completed", "cancelled"):
+        return f"Status: TASK_ERROR\nTask: {task_ref}\nNext-Action: Repair the existing task record through its owner before continuing; do not create a replacement task."
 
     task_title = task_data.get("title", task_ref)
     task_status = task_data.get("status", "unknown")
@@ -475,7 +472,7 @@ def _get_task_status(trellis_dir: Path, input_data: dict) -> str:
     if task_status == "planning":
         next_bits = [
             "Follow the current per-turn workflow-state; task lifecycle status and artifact presence do not identify the business phase",
-            "If no phase route is initialized, load `trellis-goal-exploration-and-requirements` and confirm the requirements baseline before initializing the route",
+            "If no phase route is initialized, initialize it through Trellis CLI, load `trellis-goal-exploration-and-requirements`, and obtain user confirmation for the recorded requirements artifact before advancing",
         ]
         if not jsonl_ready:
             next_bits.append("curate task context manifests only when a dispatched agent needs them")
@@ -698,13 +695,15 @@ def _build_compact_current_state(
     active = _resolve_active_task(trellis_dir, input_data)
     if active.task_path:
         task_dir = _resolve_task_dir(trellis_dir, active.task_path)
-        status = "unknown"
+        status = "task_error"
         task_json = task_dir / "task.json"
         if task_json.is_file():
             try:
                 data = json.loads(task_json.read_text(encoding="utf-8"))
                 if isinstance(data, dict):
-                    status = str(data.get("status") or "unknown")
+                    value = data.get("status")
+                    if value in ("planning", "in_progress", "completed", "cancelled"):
+                        status = value
             except (json.JSONDecodeError, OSError):
                 pass  # Optional task metadata; fall back to generic status.
         lines.append(f"Current task: {_repo_relative(repo_root, task_dir)}; status={status}.")
@@ -859,7 +858,12 @@ def main():
             project_dir = Path(_normalize_windows_shell_path(val)).resolve()
             break
     if project_dir is None:
-        project_dir = Path(_normalize_windows_shell_path(hook_input.get("cwd", "."))).resolve()
+        raw_cwd = hook_input.get("cwd")
+        project_dir = Path(_normalize_windows_shell_path(raw_cwd if isinstance(raw_cwd, str) and raw_cwd else ".")).resolve()
+
+    project_dir = next((candidate for candidate in (project_dir, *project_dir.parents) if (candidate / ".trellis").is_dir()), None)
+    if project_dir is None or not (project_dir / ".trellis" / "scripts" / "common" / "active_task.py").is_file():
+        return
 
     trellis_dir = project_dir / ".trellis"
     context_key = _resolve_context_key(trellis_dir, hook_input)

package/dist/templates/trellis/agents/delegated-worktree-primary-agent.md

@@ -16,3 +16,12 @@ start another delegated run. Verify the changes with relevant project checks
 and report the files changed, evidence, and any remaining limitation. Stop and
 report if the contract conflicts with repository instructions or requires a
 materially different scope.
+
+Treat `.trellis/tasks/`, task ownership, session pointers, runtime state, and
+workflow acceptance as read-only control-plane facts. Do not invoke task CLI
+write commands, including create, start, finish, set-meta, phase, transfer,
+link/unlink, rename, delegate, or lifecycle commands. Write the assigned result
+artifact only at its supplied path; do not create a second task contract.
+One level of bounded read-only Teamwork research or review is allowed when the
+parent contract permits it. Those teammates must not implement code or delegate
+again. These are role obligations, not a sandbox guarantee.

package/dist/templates/trellis/agents/profiles/architecture.md

@@ -0,0 +1,9 @@
+# 架构与方案评估（architecture）
+
+你负责评估 brief 指定的架构问题和实质候选。共同角色卡规定的范围、结果写入和停止条件始终适用。
+
+输入应包含目标与约束、当前结构、受影响边界、候选或待决问题和接受条件。先核对现有职责与接口，再比较满足当前需求的候选，包括数据与控制流、失败恢复、兼容与迁移、可验证性及维护成本。必要的源码探索或外部补证必须服务于当前决定。
+
+结果应包含推荐及依据、排除候选与理由、接口和边界、关键情景、风险、实施与验证建议，以及仍须用户决定的取舍。证据足以评估候选后停止；不要为假设的未来增加框架，不自行扩充规划权限或实施授权。最终结论由协调者归并。
+
+必要输入缺失、角色与 brief 冲突或需要越界操作时，报告阻断。不编写产品源码、测试或修复，不替协调者接受结果，不继续委派。