syntaur 0.1.14 → 0.3.0

package/platforms/claude-code/skills/syntaur-protocol/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: syntaur-protocol
-description: This skill should be used when the user mentions "syntaur", "assignment", "mission", works with files under ~/.syntaur/, references assignment.md, plan.md, handoff.md, or discusses the Syntaur protocol, lifecycle states, or write boundaries.
+description: This skill should be used when the user mentions "syntaur", "assignment", "project", works with files under ~/.syntaur/, references assignment.md, plan.md, handoff.md, or discusses the Syntaur protocol, lifecycle states, or write boundaries.
 version: 0.1.0
 ---
 
@@ -12,29 +12,34 @@ You are working within the Syntaur protocol. Follow these rules at all times.
 
 You MUST respect file ownership boundaries. Violations will be blocked by the PreToolUse hook.
 
-### Files you may WRITE:
+### Files you may WRITE directly:
 1. **Your assignment folder** -- only the assignment you are currently working on:
-   - `assignment.md`, `plan.md`, `scratchpad.md`, `handoff.md`, `decision-record.md`
-   - Path: `~/.syntaur/missions/<mission>/assignments/<your-assignment>/`
-2. **Shared resources and memories** at the mission level:
-   - `~/.syntaur/missions/<mission>/resources/<slug>.md`
-   - `~/.syntaur/missions/<mission>/memories/<slug>.md`
+   - `assignment.md`, `plan*.md` (0 or more versioned plan files), `progress.md`, `scratchpad.md`, `handoff.md`, `decision-record.md`
+   - Path (project-nested): `~/.syntaur/projects/<project>/assignments/<your-assignment>/`
+   - Path (standalone): `~/.syntaur/assignments/<your-assignment-uuid>/` — folder named by UUID, `project: null`, `slug` display-only
+2. **Shared resources and memories** at the project level:
+   - `~/.syntaur/projects/<project>/resources/<slug>.md`
+   - `~/.syntaur/projects/<project>/memories/<slug>.md`
 3. **Your workspace** -- source code files within the workspace defined in your assignment's frontmatter (`workspace.worktreePath` or `workspace.repository`)
 4. **Context file** -- `.syntaur/context.json` in the current working directory
 
+### Files written only via CLI (never edit directly):
+- `comments.md` (any assignment) — use `syntaur comment <slug-or-uuid> "body" --type question|note|feedback [--reply-to <id>]`. Never edit directly. Questions carry a `resolved` flag toggled in the dashboard.
+- Another assignment's `## Todos` section — use `syntaur request <target> "text"` to append a todo annotated `(from: <source>)`.
+
 ### Files you must NEVER write:
-1. `mission.md`, `agent.md`, `claude.md` -- human-authored, read-only
+1. `project.md` -- human-authored, read-only
 2. `manifest.md` -- derived, rebuilt by tooling
 3. Any file prefixed with `_` (`_index-*.md`, `_status.md`) -- derived
-4. Other agents' assignment folders
+4. Other agents' assignment folders (except via the CLI-mediated channels above)
 5. Any files outside your workspace boundary
 
 ## Current Assignment Context
 
 If `.syntaur/context.json` exists in the current working directory, read it to determine:
-- `missionSlug` -- which mission you are working on
+- `projectSlug` -- which project you are working on
 - `assignmentSlug` -- which assignment is yours
-- `missionDir` -- absolute path to the mission folder
+- `projectDir` -- absolute path to the project folder
 - `assignmentDir` -- absolute path to your assignment folder
 - `workspaceRoot` -- absolute path to your code workspace (if set)
 
@@ -46,14 +51,21 @@ For detailed protocol information, read these files:
 
 ## Lifecycle Commands
 
-Use the `syntaur` CLI for state transitions. Available commands:
-- `syntaur assign <slug> --agent <name> --mission <mission>` -- set assignee
-- `syntaur start <slug> --mission <mission>` -- pending -> in_progress
-- `syntaur review <slug> --mission <mission>` -- in_progress -> review
-- `syntaur complete <slug> --mission <mission>` -- in_progress/review -> completed
-- `syntaur block <slug> --mission <mission> --reason <text>` -- block an assignment
-- `syntaur unblock <slug> --mission <mission>` -- unblock
-- `syntaur fail <slug> --mission <mission>` -- mark as failed
+Use the `syntaur` CLI for state transitions and coordination:
+- `syntaur assign <slug> --agent <name> --project <project>` -- set assignee
+- `syntaur start <slug> --project <project>` -- pending -> in_progress
+- `syntaur review <slug> --project <project>` -- in_progress -> review
+- `syntaur complete <slug> --project <project>` -- in_progress/review -> completed
+- `syntaur block <slug> --project <project> --reason <text>` -- block an assignment
+- `syntaur unblock <slug> --project <project>` -- unblock
+- `syntaur fail <slug> --project <project>` -- mark as failed
+- `syntaur create-assignment "<title>" [--type <type>] [--project <slug> | --one-off]` -- create project-nested or standalone assignment
+- `syntaur comment <slug-or-uuid> "body" --type question|note|feedback [--reply-to <id>]` -- append to `comments.md`
+- `syntaur request <target> "text" [--from <source>]` -- append a todo to another assignment's `## Todos`
+
+## Troubleshooting
+
+If Syntaur state looks inconsistent (missing files, stale manifests, unexpected hook blocks), run `syntaur doctor` to diagnose. The `/doctor-syntaur` slash command wraps it and helps interpret results.
 
 ## Playbooks
 
@@ -65,8 +77,10 @@ ls ~/.syntaur/playbooks/*.md 2>/dev/null
 
 ## Conventions
 
-- Assignment frontmatter is the single source of truth for state
-- Slugs are lowercase, hyphen-separated
-- Always read `agent.md` and `claude.md` at the mission level before starting work
-- Add unanswered questions to the Q&A section of assignment.md (do not set status to blocked for questions)
-- Commit frequently with messages referencing the assignment slug
+- Assignment frontmatter is the single source of truth for state. `project` is the containing project slug (`null` for standalone); `type` is a classification validated against `config.md` `types.definitions` when present.
+- Slugs are lowercase, hyphen-separated. For standalone assignments, the folder is named by UUID; `slug` is display-only.
+- Always read `project.md` at the project level (when project-nested) before starting work.
+- Append timestamped entries to `progress.md` as work lands — do NOT add a `## Progress` section to `assignment.md`.
+- Record questions/notes/feedback via `syntaur comment` — never edit `comments.md` directly. Do NOT set status to blocked for questions.
+- Use `syntaur request` to route work to another assignment.
+- Commit frequently with messages referencing the assignment slug.

package/platforms/codex/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "syntaur",
   "version": "0.1.7",
-  "description": "Run Syntaur mission and assignment workflows from Codex, including claiming work, planning, completing handoffs, session tracking, and write-boundary enforcement.",
+  "description": "Run Syntaur project and assignment workflows from Codex, including claiming work, planning, completing handoffs, session tracking, and write-boundary enforcement.",
   "author": {
     "name": "Brennen"
   },
@@ -9,8 +9,8 @@
   "hooks": "./hooks.json",
   "interface": {
     "displayName": "Syntaur",
-    "shortDescription": "Mission and assignment workflows for Codex",
-    "longDescription": "Use Syntaur to create missions and assignments, claim work, keep plan and handoff records current, track Codex sessions, and enforce Syntaur write boundaries.",
+    "shortDescription": "Project and assignment workflows for Codex",
+    "longDescription": "Use Syntaur to create projects and assignments, claim work, keep plan and handoff records current, track Codex sessions, and enforce Syntaur write boundaries.",
     "developerName": "Brennen",
     "category": "Coding",
     "capabilities": [

package/platforms/codex/README.md

@@ -4,7 +4,7 @@ Syntaur plugin for OpenAI Codex. Installed automatically during `syntaur setup`.
 
 ## What's included
 
-- **Skills:** syntaur-protocol, create-mission, create-assignment, grab-assignment, plan-assignment, complete-assignment, track-session
+- **Skills:** syntaur-protocol, create-project, create-assignment, grab-assignment, plan-assignment, complete-assignment, track-session
 - **Hooks:** write boundary enforcement, session cleanup
 - **Commands:** track-session
 - **Agents:** syntaur-protocol (background)

package/platforms/codex/adapters/AGENTS.md.template

@@ -4,7 +4,7 @@ This is a reference template for the Codex and OpenCode adapters.
 
 The `syntaur setup-adapter codex` or `syntaur setup-adapter opencode`
 command generates `AGENTS.md` dynamically in your workspace with
-mission and assignment context filled in.
+project and assignment context filled in.
 
 The generated file now does two things:
 
@@ -12,5 +12,5 @@ The generated file now does two things:
 2. points Codex at the reusable Syntaur Codex plugin workflows (`syntaur-protocol`, `grab-assignment`, `plan-assignment`, `complete-assignment`, and related helpers) when that plugin is installed globally
 
 See the rendered output by running:
-  syntaur setup-adapter codex --mission <slug> --assignment <slug>
-  syntaur setup-adapter opencode --mission <slug> --assignment <slug>
+  syntaur setup-adapter codex --project <slug> --assignment <slug>
+  syntaur setup-adapter opencode --project <slug> --assignment <slug>

package/platforms/codex/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
   display_name: "Syntaur"
-  short_description: "Mission and assignment workflows for Codex"
-  default_prompt: "Use Syntaur to create missions and assignments, claim work, plan an assignment, or complete a handoff in the current workspace."
+  short_description: "Project and assignment workflows for Codex"
+  default_prompt: "Use Syntaur to create projects and assignments, claim work, plan an assignment, or complete a handoff in the current workspace."
 
 policy:
   allow_implicit_invocation: true

package/platforms/codex/agents/syntaur-operator.md

@@ -1,6 +1,6 @@
 ---
 name: syntaur-operator
-description: Specializes in the Syntaur CLI and protocol: mission and assignment scaffolding, claiming work, maintaining assignment records, planning, handoffs, session tracking, adapter setup, lifecycle transitions, and write-boundary enforcement. Use when working with ~/.syntaur/, assignment.md, plan.md, handoff.md, .syntaur/context.json, or the syntaur CLI.
+description: Specializes in the Syntaur CLI and protocol: project and assignment scaffolding, claiming work, maintaining assignment records, planning (versioned plan files), handoffs, session tracking, adapter setup, lifecycle transitions, and write-boundary enforcement. Use when working with ~/.syntaur/, assignment.md, plan*.md, handoff.md, .syntaur/context.json, or the syntaur CLI.
 ---
 
 You are the Syntaur Operator for Codex.
@@ -9,9 +9,10 @@ Your job is to work fluently within the Syntaur protocol without breaking owners
 
 ## Primary Responsibilities
 
-- Create missions and assignments with the `syntaur` CLI
+- Create projects and assignments (project-nested or standalone) with the `syntaur` CLI
 - Claim assignments and establish local assignment context
-- Keep `assignment.md`, `plan.md`, and `handoff.md` accurate during execution
+- Keep `assignment.md`, active plan files (`plan.md`, `plan-v2.md`, ...), `progress.md`, and `handoff.md` accurate during execution
+- Record questions/notes/feedback via `syntaur comment` and route cross-assignment work via `syntaur request`
 - Track Codex sessions for the Syntaur dashboard
 - Set up Codex adapter instructions in the active workspace
 - Enforce Syntaur write boundaries and lifecycle rules
@@ -20,96 +21,110 @@ Your job is to work fluently within the Syntaur protocol without breaking owners
 
 When a task involves Syntaur:
 
-1. Determine whether the user needs mission creation, assignment creation, assignment execution, completion/handoff, or session tracking.
+1. Determine whether the user needs project creation, assignment creation (project-nested or `--one-off` standalone), assignment execution, completion/handoff, or session tracking.
 2. If `.syntaur/context.json` exists in the current working directory, read it first.
 3. If working on a specific assignment, read these in order:
-   - `<missionDir>/manifest.md`
-   - `<missionDir>/agent.md`
-   - `<missionDir>/mission.md`
-   - `<missionDir>/claude.md` if it exists
-   - `<assignmentDir>/assignment.md`
-   - `<assignmentDir>/plan.md`
+   - `<projectDir>/manifest.md` (project-nested assignments only)
+   - `<projectDir>/project.md` (project-nested assignments only)
+   - `<assignmentDir>/assignment.md` — frontmatter now includes `project: <slug> | null` and `type: <classification> | null`
+   - any `<assignmentDir>/plan*.md` files linked from active todos in the `## Todos` section
+   - `<assignmentDir>/progress.md` (if present) — reverse-chron progress log
+   - `<assignmentDir>/comments.md` (if present) — threaded questions/notes/feedback
    - `<assignmentDir>/handoff.md`
 4. Resolve the workspace boundary from `.syntaur/context.json` or `assignment.md` frontmatter before editing code.
 
+Project-nested assignments live at `~/.syntaur/projects/<slug>/assignments/<aslug>/`. Standalone assignments live at `~/.syntaur/assignments/<uuid>/` — folder named by UUID, `project: null`, `slug` display-only.
+
 ## File Ownership
 
 ### Never write
 
-- `mission.md`
-- `agent.md`
-- `claude.md`
+- `project.md`
 - `manifest.md`
 - any underscore-prefixed derived file such as `_index-assignments.md`, `_status.md`, `resources/_index.md`, or `memories/_index.md`
-- other agents' assignment folders
+- other agents' assignment folders, except via CLI-mediated channels
 
-### You may write
+### You may write directly
 
 - the current assignment folder only:
   - `assignment.md`
-  - `plan.md`
+  - `plan*.md` (0 or more versioned plan files, e.g., `plan.md`, `plan-v2.md`)
+  - `progress.md` (append timestamped entries, newest first — replaces the old `## Progress` section)
   - `scratchpad.md`
   - `handoff.md`
   - `decision-record.md`
-- mission `resources/*.md`
-- mission `memories/*.md`
+- project `resources/*.md`
+- project `memories/*.md`
 - `.syntaur/context.json` in the current working directory
 - source files inside the assignment workspace boundary
 
+### Write only via CLI (never edit directly)
+
+- `comments.md` (any assignment) — use `syntaur comment <slug-or-uuid> "body" --type question|note|feedback [--reply-to <id>]`. Never edit directly. Questions carry a `resolved` flag toggled in the dashboard.
+- Another assignment's `## Todos` section — use `syntaur request <source> <target> "text"` to append a todo annotated `(from: <source>)`.
+
 ## Protocol Rules
 
-- Assignment frontmatter is the single source of truth for assignment state.
-- Slugs are lowercase and hyphen-separated.
+- Assignment frontmatter is the single source of truth for assignment state. `project` is the containing project slug (`null` for standalone); `type` is a classification validated against `config.md` `types.definitions` when present.
+- Slugs are lowercase and hyphen-separated. Standalone assignment folders are named by UUID; `slug` is display-only in that case.
 - `pending` with unmet `dependsOn` means structural waiting. `blocked` means a real runtime obstacle and requires a `blockedReason`.
-- Update acceptance criteria checkboxes as work lands.
-- Keep the `## Progress` section in `assignment.md` current after meaningful milestones.
+- `dependsOn` is only valid between assignments within the same project — standalone assignments cannot declare dependencies.
+- Update acceptance criteria and `## Todos` checkboxes as work lands.
+- Append timestamped entries to `progress.md` (not to `assignment.md`) after meaningful milestones.
+- When requirements shift, supersede the prior plan todo instead of rewriting the old plan file.
 - Append handoffs instead of replacing previous handoff entries.
+- Record questions via `syntaur comment ... --type question` — they roll up into `_status.md`'s `openQuestions` counter.
 
 ## CLI Reference
 
 Use these commands directly when needed:
 
-- `syntaur create-mission "<title>" [--slug <slug>] [--dir <path>]`
-- `syntaur create-assignment "<title>" --mission <slug> [--slug <slug>] [--priority <level>] [--depends-on <slugs>] [--dir <path>]`
-- `syntaur create-assignment "<title>" --one-off [--slug <slug>] [--priority <level>] [--dir <path>]`
+- `syntaur create-project "<title>" [--slug <slug>] [--dir <path>]`
+- `syntaur create-assignment "<title>" --project <slug> [--slug <slug>] [--priority <level>] [--depends-on <slugs>] [--type <type>] [--dir <path>]`
+- `syntaur create-assignment "<title>" --one-off [--slug <slug>] [--priority <level>] [--type <type>] [--dir <path>]` — creates standalone at `~/.syntaur/assignments/<uuid>/`
 - `syntaur setup [--yes] [--claude] [--codex] [--claude-dir <path>] [--codex-dir <path>] [--codex-marketplace-path <path>] [--dashboard]`
-- `syntaur assign <assignment-slug> --agent codex --mission <mission-slug>`
-- `syntaur start <assignment-slug> --mission <mission-slug>`
-- `syntaur review <assignment-slug> --mission <mission-slug>`
-- `syntaur complete <assignment-slug> --mission <mission-slug>`
-- `syntaur block <assignment-slug> --mission <mission-slug> --reason <text>`
-- `syntaur unblock <assignment-slug> --mission <mission-slug>`
-- `syntaur fail <assignment-slug> --mission <mission-slug>`
+- `syntaur assign <assignment-slug> --agent codex --project <project-slug>`
+- `syntaur start <assignment-slug> --project <project-slug>`
+- `syntaur review <assignment-slug> --project <project-slug>`
+- `syntaur complete <assignment-slug> --project <project-slug>`
+- `syntaur block <assignment-slug> --project <project-slug> --reason <text>`
+- `syntaur unblock <assignment-slug> --project <project-slug>`
+- `syntaur fail <assignment-slug> --project <project-slug>`
+- `syntaur comment <assignment-slug-or-uuid> "body" --type question|note|feedback [--reply-to <id>] [--project <slug>]` — append to `comments.md`
+- `syntaur request <target-slug-or-uuid> "text" [--from <source>] [--project <slug>]` — append to target's `## Todos`, annotated `(from: <source>)`
 - `syntaur uninstall [--all] [--yes]`
-- `syntaur track-session --mission <mission-slug> --assignment <assignment-slug> --agent codex --session-id <id> --path <cwd>`
-- `syntaur setup-adapter codex --mission <mission-slug> --assignment <assignment-slug>`
+- `syntaur track-session --project <project-slug> --assignment <assignment-slug> --agent codex --session-id <id> --path <cwd>`
+- `syntaur setup-adapter codex --project <project-slug> --assignment <assignment-slug>`
 
 ## Standard Workflows
 
 ### Claim an assignment
 
-1. Discover the mission and pending assignments.
+1. Discover the project and pending assignments.
 2. Run `syntaur assign ... --agent codex`.
 3. Run `syntaur start ...`.
 4. Create `.syntaur/context.json` in the working directory.
 5. Register the session with `syntaur track-session`.
-6. If needed, run `syntaur setup-adapter codex --mission <slug> --assignment <slug>`.
+6. If needed, run `syntaur setup-adapter codex --project <slug> --assignment <slug>`.
 
 ### Plan an assignment
 
-1. Read the assignment, mission instructions, and any dependency handoffs.
+1. Read the assignment, project instructions, and any dependency handoffs.
 2. Explore the workspace.
-3. Replace the body of `plan.md` with a concrete implementation plan.
-4. Keep `assignment.md` in sync with what is now known.
+3. Determine the next plan filename: `plan.md` if no `plan*.md` exists, otherwise the smallest unused `plan-v<N>.md` (N >= 2).
+4. Write the plan file with standard frontmatter (`assignment`, `status: draft`, `created`, `updated`) and body.
+5. Update `assignment.md`'s `## Todos` section: supersede any prior active plan todo (`- [x] ~~...~~ (superseded by plan-v<N>)`), then append a new `- [ ] Execute [<label>](./<planFilename>)` todo.
+6. Keep `assignment.md` in sync with what is now known.
 
 ### Complete an assignment
 
 1. Re-check every acceptance criterion.
 2. Update any missing checkboxes in `assignment.md`.
-3. Append a new structured handoff entry to `handoff.md`.
-4. Mark the dashboard session completed if `sessionId` exists.
-5. Transition the assignment with `syntaur review` or `syntaur complete`.
-6. Remove `.syntaur/context.json` when the assignment is no longer active.
+3. Append a final timestamped entry to `progress.md` summarizing the work.
+4. Append a new structured handoff entry to `handoff.md`.
+5. Mark the dashboard session completed if `sessionId` exists.
+6. Transition the assignment with `syntaur review` or `syntaur complete`.
+7. Remove `.syntaur/context.json` when the assignment is no longer active.
 
 ## Decision Rules
 

package/platforms/codex/references/file-ownership.md

@@ -6,9 +6,7 @@ Agents must never modify these files:
 
 | File | Location |
 |------|----------|
-| `mission.md` | `<mission>/mission.md` |
-| `agent.md` | `<mission>/agent.md` |
-| `claude.md` | `<mission>/claude.md` |
+| `project.md` | `<project>/project.md` |
 
 ## Agent-Writable (Your Assignment Folder Only)
 
@@ -16,20 +14,33 @@ You may only write to files inside your assigned assignment folder:
 
 | File | Purpose |
 |------|---------|
-| `assignment.md` | Assignment record and source of truth for state |
-| `plan.md` | Your implementation plan |
+| `assignment.md` | Assignment record and source of truth for state (includes `## Todos` checklist) |
+| `plan*.md` | Versioned implementation plans (optional, 0 or more: `plan.md`, `plan-v2.md`, ...) — each linked from a todo in `assignment.md` |
+| `progress.md` | Append-only timestamped progress log (newest first). Replaces the old `## Progress` body section. |
 | `scratchpad.md` | Working notes |
 | `handoff.md` | Append-only handoff log |
 | `decision-record.md` | Append-only decision log |
 
-Path pattern: `~/.syntaur/missions/<mission>/assignments/<your-assignment>/`
+Path pattern (project-nested): `~/.syntaur/projects/<project>/assignments/<your-assignment>/`
+Path pattern (standalone): `~/.syntaur/assignments/<your-assignment-uuid>/`
+
+## CLI-Mediated Shared-Writable
+
+Do not edit these files directly. Use the listed CLI commands:
+
+| File | Mediator |
+|------|----------|
+| `comments.md` (any assignment) | `syntaur comment <slug-or-uuid> "body" [--type question\|note\|feedback] [--reply-to <id>]` |
+| `## Todos` in another assignment's `assignment.md` (cross-assignment request) | `syntaur request <source> <target> "text"` |
+
+These are bounded exceptions to the single-writer rule.
 
 ## Shared-Writable
 
 | Location | Purpose |
 |----------|---------|
-| `<mission>/resources/<slug>.md` | Reference material |
-| `<mission>/memories/<slug>.md` | Learnings and reusable patterns |
+| `<project>/resources/<slug>.md` | Reference material |
+| `<project>/memories/<slug>.md` | Learnings and reusable patterns |
 
 ## Derived (Never Edit)
 

package/platforms/codex/references/protocol-summary.md

@@ -1,24 +1,26 @@
 # Syntaur Protocol Summary
 
+Protocol version: **2.0**
+
 ## Directory Structure
 
 ```
 ~/.syntaur/
   config.md
-  missions/
-    <mission-slug>/
+  projects/
+    <project-slug>/
       manifest.md            # Derived: root navigation (read-only)
-      mission.md             # Human-authored: mission overview (read-only)
+      project.md             # Human-authored: project overview (read-only)
       _index-assignments.md  # Derived (read-only)
       _index-plans.md        # Derived (read-only)
       _index-decisions.md    # Derived (read-only)
       _status.md             # Derived (read-only)
-      claude.md              # Human-authored: Claude-specific instructions (read-only)
-      agent.md               # Human-authored: universal agent instructions (read-only)
       assignments/
         <assignment-slug>/
-          assignment.md      # Agent-writable: source of truth for state
-          plan.md            # Agent-writable: implementation plan
+          assignment.md      # Agent-writable: source of truth for state (includes ## Todos checklist)
+          plan*.md           # Agent-writable: versioned implementation plans (optional, 0 or more: plan.md, plan-v2.md, ...)
+          progress.md        # Agent-writable, append-only: timestamped progress log
+          comments.md        # CLI-mediated: threaded questions/notes/feedback (via `syntaur comment`)
           scratchpad.md      # Agent-writable: working notes
           handoff.md         # Agent-writable: append-only handoff log
           decision-record.md # Agent-writable: append-only decision log
@@ -28,6 +30,18 @@
       memories/
         _index.md            # Derived (read-only)
         <memory-slug>.md     # Shared-writable
+  assignments/
+    <assignment-id>/         # Standalone assignments — folder named by UUID, `project: null`
+      assignment.md          # Same schema as project-nested, `slug` is display-only
+      plan*.md
+      progress.md
+      comments.md
+      scratchpad.md
+      handoff.md
+      decision-record.md
+  playbooks/
+    manifest.md              # Derived: playbook listing (read-only)
+    <slug>.md                # User-authored: behavioral rules for agents
 ```
 
 ## Assignment Lifecycle
@@ -59,8 +73,13 @@
 ## Key Rules
 
 1. Assignment frontmatter is the single source of truth for assignment state.
-2. One folder per mission and one subfolder per assignment.
+2. Project-nested assignments live at `projects/<slug>/assignments/<aslug>/` (folder = slug). Standalone assignments live at `assignments/<uuid>/` (folder = UUID, `project: null`, slug display-only).
 3. Derived files are never edited manually.
 4. Slugs are lowercase and hyphen-separated.
-5. Dependencies are declared via `dependsOn` in assignment frontmatter.
+5. Dependencies are declared via `dependsOn` in assignment frontmatter. Only valid within the same project.
 6. An assignment cannot transition from `pending` to `in_progress` while any dependency is not `completed`.
+7. The `## Todos` section in `assignment.md` is an informal markdown checklist. Items may be simple tasks or link to plan files. When a plan is superseded, mark the old todo: `- [x] ~~Execute [plan](./plan.md)~~ (superseded by plan-v2)` — never delete it. `## Todos` also receives cross-assignment requests via `syntaur request`.
+8. Playbooks in `~/.syntaur/playbooks/` define behavioral rules agents must follow. Read `manifest.md` for a summary, then read each referenced playbook before starting work.
+9. Progress is appended to `progress.md` as timestamped entries (newest first). Do not add a `## Progress` section to `assignment.md`.
+10. Comments are appended to `comments.md` via `syntaur comment <slug> "body" [--type question|note|feedback] [--reply-to <id>]`. Never edit `comments.md` directly.
+11. Cross-assignment work is requested via `syntaur request <source> <target> "text"` — appends to the target's `## Todos` annotated `(from: <source>)`.

package/platforms/codex/scripts/enforce-boundaries.sh

@@ -51,7 +51,7 @@ if [ ! -f "$CONTEXT_FILE" ]; then
 fi
 
 ASSIGNMENT_DIR=$(jq -r '.assignmentDir // empty' "$CONTEXT_FILE" 2>/dev/null)
-MISSION_DIR=$(jq -r '.missionDir // empty' "$CONTEXT_FILE" 2>/dev/null)
+MISSION_DIR=$(jq -r '.projectDir // empty' "$CONTEXT_FILE" 2>/dev/null)
 WORKSPACE_ROOT=$(jq -r '.workspaceRoot // empty' "$CONTEXT_FILE" 2>/dev/null)
 
 if [ -z "$ASSIGNMENT_DIR" ] || [ -z "$MISSION_DIR" ]; then
@@ -93,7 +93,7 @@ if [ -n "$WORKSPACE_ROOT" ] && [[ "$FILE_PATH" == "$WORKSPACE_ROOT"/* ]]; then
   allow_and_exit
 fi
 
-REASON="Syntaur write boundary violation: Cannot write to '$FILE_PATH'. Allowed paths: assignment dir ($ASSIGNMENT_DIR), mission resources/memories, workspace ($WORKSPACE_ROOT)."
+REASON="Syntaur write boundary violation: Cannot write to '$FILE_PATH'. Allowed paths: assignment dir ($ASSIGNMENT_DIR), project resources/memories, workspace ($WORKSPACE_ROOT)."
 REASON_ESCAPED=$(echo "$REASON" | jq -Rs '.' 2>/dev/null)
 if [ -z "$REASON_ESCAPED" ]; then
   REASON_ESCAPED="\"Syntaur write boundary violation\""

package/platforms/codex/scripts/session-cleanup.sh

@@ -24,7 +24,7 @@ if [ ! -f "$CONTEXT_FILE" ]; then
 fi
 
 SESSION_ID=$(jq -r '.sessionId // empty' "$CONTEXT_FILE" 2>/dev/null)
-MISSION_SLUG=$(jq -r '.missionSlug // empty' "$CONTEXT_FILE" 2>/dev/null)
+MISSION_SLUG=$(jq -r '.projectSlug // empty' "$CONTEXT_FILE" 2>/dev/null)
 
 if [ -z "$SESSION_ID" ] || [ -z "$MISSION_SLUG" ]; then
   exit 0
@@ -33,7 +33,7 @@ fi
 PORT=$(cat "$HOME/.syntaur/dashboard-port" 2>/dev/null || echo "4800")
 curl -sf -X PATCH "http://localhost:${PORT}/api/agent-sessions/${SESSION_ID}/status" \
   -H "Content-Type: application/json" \
-  -d "{\"status\": \"stopped\", \"missionSlug\": \"${MISSION_SLUG}\"}" \
+  -d "{\"status\": \"stopped\", \"projectSlug\": \"${MISSION_SLUG}\"}" \
   -o /dev/null 2>/dev/null || true
 
 exit 0

package/platforms/codex/skills/complete-assignment/SKILL.md

@@ -11,12 +11,13 @@ Write a handoff for the current Syntaur assignment and transition it to `review`
 
 User arguments: `$ARGUMENTS`
 
-If the user passed `--complete`, transition directly to `completed` only when all acceptance criteria are met. Otherwise transition to `review`.
+If the user passed `--complete`, transition directly to `completed` only when all acceptance criteria are met AND all todos are either checked or marked superseded. Otherwise transition to `review`.
 
 ## Workflow
 
 1. Read `.syntaur/context.json`. If it does not exist, tell the user there is no active assignment.
-2. Read `<assignmentDir>/assignment.md` and evaluate every item in the `## Acceptance Criteria` section.
+2. Read `<assignmentDir>/assignment.md` and evaluate every item in the `## Acceptance Criteria` section AND every item in the `## Todos` section. Superseded todos (marked `- [x] ~~...~~ (superseded by ...)`) count as resolved. If any acceptance criterion is unmet OR any todo is still `- [ ]` and not superseded, warn the user before proceeding.
+2.5. Append a final entry to `<assignmentDir>/progress.md` (reverse-chron, newest first) under a new `## <ISO 8601 timestamp>` heading summarizing the final state of the work. Bump `entryCount` and `updated` in the frontmatter. Do NOT add a `## Progress` section to `assignment.md` — progress entries live exclusively in `progress.md` as of protocol v2.0.
 3. Read `<assignmentDir>/handoff.md` and append a new handoff entry using the protocol format:
 
 ```markdown
@@ -44,18 +45,18 @@ If the user passed `--complete`, transition directly to `completed` only when al
 4. Update the handoff frontmatter:
    - set `updated` to the current timestamp
    - increment `handoffCount`
-5. Update acceptance criteria checkboxes in `assignment.md` to match reality.
+5. Update acceptance criteria and todo checkboxes in `assignment.md` to match reality. Do NOT modify superseded todo lines (those matching `- [x] ~~...~~ (superseded by ...)`).
 6. If `.syntaur/context.json` includes `sessionId`, mark that session as completed through the dashboard API:
 
 ```bash
 curl -s -X PATCH "http://localhost:$(cat ~/.syntaur/dashboard-port 2>/dev/null || echo 4800)/api/agent-sessions/<session-id>/status" \
   -H "Content-Type: application/json" \
-  -d '{"status":"completed","missionSlug":"<mission-slug>"}'
+  -d '{"status":"completed","projectSlug":"<project-slug>"}'
 ```
 
 7. Transition the assignment:
-   - `syntaur complete <assignment-slug> --mission <mission-slug>` when `--complete` is allowed
-   - otherwise `syntaur review <assignment-slug> --mission <mission-slug>`
+   - `syntaur complete <assignment-slug> --project <project-slug>` when `--complete` is allowed
+   - otherwise `syntaur review <assignment-slug> --project <project-slug>`
 8. Delete `.syntaur/context.json`.
 9. Summarize:
    - new status

package/platforms/codex/skills/create-assignment/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: create-assignment
-description: Use when the user wants to create a new Syntaur assignment inside a mission or as a one-off mission plus assignment.
+description: Use when the user wants to create a new Syntaur assignment inside a project or as a one-off project plus assignment.
 ---
 
 # Create Assignment
@@ -14,30 +14,36 @@ User arguments: `$ARGUMENTS`
 Parse:
 
 - First positional argument: assignment title
-- `--mission <slug>` required unless `--one-off`
-- `--one-off` optional
+- `--project <slug>` required unless `--one-off`
+- `--one-off` optional — creates a **standalone** assignment at `~/.syntaur/assignments/<uuid>/` with `project: null`. Folder named by UUID; `slug` is display-only. `--depends-on` is not permitted for standalone assignments.
 - `--slug <slug>` optional
 - `--priority <level>` optional, default `medium`
-- `--depends-on <slug[,slug...]>` optional
+- `--type <type>` optional — classification such as `feature`, `bug`, `refactor`, `research`, `chore`. Defaults to `feature`. When `~/.syntaur/config.md` defines `types.definitions`, the CLI validates against that list.
+- `--depends-on <slug[,slug...]>` optional (project-nested only)
 - `--dir <path>` optional
 
 If no title was provided, ask the user for it.
 
-If neither `--mission` nor `--one-off` was provided, look for `.syntaur/context.json` in the current working directory. If present, default the mission to that context's `missionSlug` and tell the user you are using it.
+If neither `--project` nor `--one-off` was provided, look for `.syntaur/context.json` in the current working directory. If present, default the project to that context's `projectSlug` and tell the user you are using it.
 
 ## Workflow
 
 1. Run one of:
-   - `syntaur create-assignment "<title>" --mission <slug> [--slug <slug>] [--priority <level>] [--depends-on <slugs>] [--dir <path>]`
-   - `syntaur create-assignment "<title>" --one-off [--slug <slug>] [--priority <level>] [--dir <path>]`
+   - `syntaur create-assignment "<title>" --project <slug> [--slug <slug>] [--priority <level>] [--depends-on <slugs>] [--type <type>] [--dir <path>]`
+   - `syntaur create-assignment "<title>" --one-off [--slug <slug>] [--priority <level>] [--type <type>] [--dir <path>]`
 2. If the command fails, report the error and stop.
 3. Read the generated `assignment.md`.
 4. Summarize:
-   - assignment slug
-   - mission slug
+   - assignment slug (for standalone assignments, also report the UUID — the folder is named by UUID, not slug)
+   - project slug (or `null` for standalone)
    - priority
+   - type
    - location
-   - created files: `assignment.md`, `plan.md`, `scratchpad.md`, `handoff.md`, `decision-record.md`
-5. Suggest next steps:
-   - fill in the objective, context, and acceptance criteria
+   - created files: `assignment.md`, `progress.md`, `comments.md`, `scratchpad.md`, `handoff.md`, `decision-record.md` (plan files are NOT scaffolded — they are created on demand by `plan-assignment`)
+5. Remind the user:
+   - Progress entries go into `progress.md` via direct appends (not into `assignment.md`).
+   - Comments are appended via `syntaur comment <slug-or-uuid> "body" --type question|note|feedback` — never edit `comments.md` directly.
+6. Suggest next steps:
+   - fill in the objective, context, acceptance criteria, and any initial todos in the `## Todos` section
+   - or run `plan-assignment` to create a plan file and auto-append a linked todo to `## Todos`
    - run `grab-assignment` to claim it if work should begin now