@firatcand/roster 0.4.0 → 1.0.1

package/templates/scaffold/dreamer/README.md

@@ -9,7 +9,7 @@ Cross-domain pattern detection matters. A lesson observed in Twitter automation
 ## Files
 
 - `agent.md` — orchestrator contract
-- `subagents/` — pattern-detector, lesson-drafter, promotion-arbiter
+- `subagents/` — pattern-detector, lesson-drafter
 - `playbook/` — the dreamer's own lessons (lessons about how to learn)
 - `logs/` — its own runs
 - `state.md` — last processed cutoff
@@ -17,7 +17,7 @@ Cross-domain pattern detection matters. A lesson observed in Twitter automation
 
 ## Invocation
 
-Nightly via the native desktop scheduler. Register with `roster schedule install` — each fire spawns a fresh CLI session in the workspace, loads `CONTEXT.md`, invokes the `roster-orchestrator` skill, and dispatches the dreamer in isolated subagent context. See `conventions.md` § Schedules and [ADR-0001](../../docs/adr/0001-scheduling-architecture.md) for the model. Subscription-billed only; `claude -p` and the Anthropic Agent SDK are banned and enforced by `roster doctor`.
+Nightly via the native desktop scheduler. Register with `roster schedule install` — each fire spawns a fresh CLI session in the workspace, loads `CONTEXT.md`, invokes the `roster-orchestrator` skill, and dispatches the dreamer in isolated subagent context. See `conventions.md` § Schedules for the model.
 
 On-demand from a session: "Run the dreamer on the last week's outreach runs across all projects."
 

package/templates/scaffold/dreamer/agent.md

@@ -45,7 +45,6 @@ Typically scheduled nightly via cron or `/schedule`. When invoked without a plan
 
 - `pattern-detector.md` — finds patterns across runs+feedback
 - `lesson-drafter.md` — drafts a single lesson in schema format
-- `promotion-arbiter.md` — decides project vs global scope for validated lessons
 
 ## Tools and bindings
 

package/templates/scaffold/dreamer/plans/nightly-reflection.yaml

@@ -1,11 +1,9 @@
 plan: nightly-reflection
 description: |
-  Reads runs and feedback across all agents and projects since the last
-  cutoff, detects patterns, drafts lesson candidates, surfaces them for HITL
-  approval via Slack #admin, and writes approved lessons to the relevant
-  playbook directories. Promotes project-scoped lessons to global when the
-  pattern is observed in 2+ projects. Updates dreamer/state.md with the new
-  cutoff and a summary.
+  Reads runs and feedback across all agents since the last cutoff, detects
+  patterns, drafts lesson candidates, surfaces them for HITL approval via
+  Slack #admin, and writes approved lessons to each agent's playbook.
+  Updates dreamer/state.md with the new cutoff and a summary.
 
 inputs:
   mode:
@@ -14,7 +12,7 @@ inputs:
     description: nightly | weekly | on-demand. Selects how aggressively to scan and how to weight evidence.
   scope:
     required: false
-    description: Limit to one project (slug) or one agent (function/agent) — useful for on-demand runs.
+    description: Limit to one agent (function/agent) — useful for on-demand runs.
   since:
     required: false
     description: ISO timestamp cutoff. If omitted, uses last_processed_through from dreamer/state.md.
@@ -24,7 +22,6 @@ outputs:
   candidates_drafted: integer
   candidates_approved: integer
   lessons_written: integer
-  lessons_promoted: integer
   conflicts_surfaced: integer
 
 steps:
@@ -35,9 +32,9 @@ steps:
 
   - id: identify_material
     description: |
-      Walk every agent's <function>/<agent>/projects/<project>/log/runs/<YYYY-MM>/
-      and log/feedback/<YYYY-MM>/ for files newer than the cutoff. Match runs
-      to feedback by filename. Apply ${inputs.scope} filter if provided.
+      Walk every agent's <function>/<agent>/log/runs/<YYYY-MM>/ and
+      log/feedback/<YYYY-MM>/ for files newer than the cutoff. Match runs to
+      feedback by filename. Apply ${inputs.scope} filter if provided.
 
   - id: detect_patterns
     subagent: pattern-detector
@@ -62,52 +59,41 @@ steps:
     description: |
       For each candidate that meets threshold or extends an existing lesson,
       draft a lesson in schema format with frontmatter (id, source: dreamer,
-      scope: project|global, status: candidate, agent, created). Place drafts
-      in dreamer/pending/.
+      status: candidate, agent, created). Place drafts in
+      <function>/<agent>/pending/.
     args:
       input_from: accumulate_evidence
 
-  - id: arbitrate_promotion
-    subagent: promotion-arbiter
-    description: |
-      For any project lesson validated in 2+ projects, decide whether to
-      promote to global scope. Returns project vs global designation per
-      candidate.
-    args:
-      input_from: draft_lessons
-
   - id: hitl_routing
     description: |
-      Post all candidates and promotions to Slack #admin (channel from
+      Post all candidates to Slack #admin (channel from
       SLACK_HITL_CHANNEL_ADMIN env var) as threaded messages, one per
       candidate. Format: "Candidate lesson <id>: <title>. Approve / Reject /
       Defer." TTL 7 days. If Slack unavailable, queue candidates locally in
-      dreamer/pending/ and retry next run.
+      <function>/<agent>/pending/ and retry next run.
     approval: slack
 
   - id: apply_approvals
     description: |
-      On approval, write the lesson to the correct location:
-        - Project-scoped: <function>/<agent>/projects/<project>/playbook/L-...md
-          with scope: project
-        - Promoted to global: <function>/<agent>/playbook/L-...md with
-          scope: global AND mark project lesson promoted_to_global: true
-        - Retired: update existing lesson's status: retired with reason
-      All dreamer-written lessons get source: dreamer in frontmatter.
-      Respect human-written lessons (source: human) — never modify or
-      supersede without explicit HITL approval.
+      On approval, move the candidate file from <function>/<agent>/pending/
+      to <function>/<agent>/playbook/L-...md. There is no scope decision;
+      v1 has a single playbook per agent. All dreamer-written lessons get
+      source: dreamer in frontmatter. Respect human-written lessons
+      (source: human) — never modify or supersede without explicit HITL
+      approval. Retired candidates update an existing lesson's status:
+      retired with reason.
 
   - id: update_state
     description: |
       Write timestamp + summary to dreamer/state.md:
         last_processed_through: <ISO timestamp>
-        last_run_summary: drafted N, approved M, written K, promoted P
+        last_run_summary: drafted N, approved M, written K
 
   - id: write_run_log
     description: |
       Write run details to dreamer/logs/<YYYY-MM>/<YYYY-MM-DD-HHMM>.md
-      including: material processed (counts by project and agent), patterns
-      detected, lesson candidates drafted (Slack thread links), promotion
-      candidates, approvals applied, conflicts surfaced.
+      including: material processed (counts by agent), patterns detected,
+      lesson candidates drafted (Slack thread links), approvals applied,
+      conflicts surfaced.
 
 approval_channel: slack

package/templates/scaffold/dreamer/subagents/lesson-drafter.md

@@ -9,20 +9,17 @@ Take a candidate pattern and draft a lesson file in the schema defined in `conve
 - `pattern` (object): output from pattern-detector
 - `existing_lesson` (object, optional): if extending an existing lesson, the current version
 - `agent` (string): which agent
-- `project` (string): which project sourced it
 
 ## Output
 
 ```yaml
 suggested_filename: L-2026-04-26-001.md
-suggested_path: <function>/<agent>/projects/<project>/playbook/   # or <function>/<agent>/playbook/
+suggested_path: <function>/<agent>/playbook/
 status: candidate
 lesson_markdown: |
   ---
   id: L-2026-04-26-001
   source: dreamer
-  scope: project                # or global
-  project: _demo              # or "—" if scope=global
   agent: sdr
   ...full frontmatter per conventions...
   ---
@@ -31,7 +28,6 @@ lesson_markdown: |
 
   ## Pattern observed
   ## Recommendation
-  ## Why this might be project-specific
   ## Retirement criteria
 ```
 
@@ -43,9 +39,8 @@ None.
 
 - Use the exact schema in `conventions.md`. Don't invent fields.
 - Always set `source: dreamer`.
-- Default to `scope: project` unless explicitly handling a promotion case.
 - Cite evidence in body, not just frontmatter.
-- Body has 4 sections: pattern, recommendation, scope reasoning, retirement criteria. That's it.
+- Body has 3 sections: pattern, recommendation, retirement criteria. That's it.
 
 ## Quality bar
 

package/templates/scaffold/{projects/_demo/guidelines → guidelines}/asset-links.md

@@ -1,3 +1,7 @@
+> **Example content — replace with your project's actuals.**
+> This file ships filled with an illustrative brand ("Acme Corp") so you can
+> see the expected shape. Overwrite freely; no agent will warn if you do.
+
 # Asset Links — Acme Corp
 
 ## Brand

package/templates/scaffold/{projects/_demo/guidelines → guidelines}/brand-book.md

@@ -1,3 +1,7 @@
+> **Example content — replace with your project's actuals.**
+> This file ships filled with an illustrative brand ("Acme Corp") so you can
+> see the expected shape. Overwrite freely; no agent will warn if you do.
+
 # Brand Book — Acme Corp
 
 ## Logo

package/templates/scaffold/{projects/_demo/guidelines → guidelines}/messaging.md

@@ -1,3 +1,7 @@
+> **Example content — replace with your project's actuals.**
+> This file ships filled with an illustrative brand ("Acme Corp") so you can
+> see the expected shape. Overwrite freely; no agent will warn if you do.
+
 # Messaging — Acme Corp
 
 ## Headline value props

package/templates/scaffold/{projects/_demo/guidelines → guidelines}/voice.md

@@ -1,3 +1,7 @@
+> **Example content — replace with your project's actuals.**
+> This file ships filled with an illustrative brand ("Acme Corp") so you can
+> see the expected shape. Overwrite freely; no agent will warn if you do.
+
 # Voice — Acme Corp
 
 ## Adjectives describing the brand voice

package/templates/scaffold/scripts/audit-agent.sh

@@ -42,7 +42,7 @@ PASSED=()
 if [ ! -f "$AGENT_DIR/agent.md" ]; then
   FAILURES+=("[$FN/$AGENT/agent.md] missing")
 else
-  REQUIRED_SECTIONS=("## Purpose" "## Inputs" "## Plans" "## Subagents" "## Tools and bindings" "## Outputs" "## Approval" "## Lessons protocol")
+  REQUIRED_SECTIONS=("## Purpose" "## Inputs" "## Plans" "## Subagents" "## Outputs" "## Approval" "## Lessons protocol")
   MISSING=()
   for section in "${REQUIRED_SECTIONS[@]}"; do
     if ! grep -qF "$section" "$AGENT_DIR/agent.md"; then
@@ -56,6 +56,14 @@ else
     PASSED+=("[$FN/$AGENT/agent.md] all required sections present")
   fi
 
+  # ## Tools and bindings is required ONLY for agents that use external tools.
+  # Missing → warning, not failure (agents reading only workspace guidelines
+  # don't need it). The chief-of-staff create-agent guided flow adds the
+  # section when the user names tools.
+  if ! grep -qF "## Tools and bindings" "$AGENT_DIR/agent.md"; then
+    WARNINGS+=("[$FN/$AGENT/agent.md] '## Tools and bindings' not declared — fine for tool-less agents; required if this agent calls external APIs")
+  fi
+
   # Steps section should NOT be present anymore — workflows live in plans/
   if grep -qE '^## Steps' "$AGENT_DIR/agent.md"; then
     WARNINGS+=("[$FN/$AGENT/agent.md] still has a '## Steps' section — workflow logic should live in plans/<plan>.yaml, not agent.md")
@@ -105,6 +113,62 @@ else
   PASSED+=("[$FN/$AGENT/README.md] present")
 fi
 
+# config.yaml — agent config (guideline refs + tool bindings).
+# Schema check: single-document mapping with agent=$FN/$AGENT, plans_dir,
+# guideline_refs (mapping), tools (mapping). Drift here breaks the runtime
+# loader (Phase 2) and `chief-of-staff create-agent` reuse.
+if [ ! -f "$AGENT_DIR/config.yaml" ]; then
+  FAILURES+=("[$FN/$AGENT/config.yaml] missing")
+  FAILURES+=("  → Suggested fix: add config.yaml at agent root with at least 'agent: $FN/$AGENT' and 'plans_dir: ./plans/'")
+elif command -v python3 >/dev/null 2>&1; then
+  CFG_RC=0
+  CFG_MSG="$(AGENT_EXPECT="$FN/$AGENT" CFG_PATH="$AGENT_DIR/config.yaml" python3 - <<'PYEOF' 2>&1
+import os, sys
+try:
+    import yaml
+except ImportError:
+    sys.stderr.write("pyyaml-missing")
+    sys.exit(2)
+expect = os.environ["AGENT_EXPECT"]
+path = os.environ["CFG_PATH"]
+with open(path) as f:
+    try:
+        doc = yaml.safe_load(f)
+    except yaml.YAMLError as e:
+        sys.stderr.write(f"yaml-parse-error: {e}")
+        sys.exit(1)
+if not isinstance(doc, dict):
+    sys.stderr.write("not-a-mapping")
+    sys.exit(1)
+errs = []
+agent = doc.get("agent")
+if agent != expect:
+    errs.append(f"agent field is {agent!r}, expected {expect!r}")
+if "plans_dir" not in doc:
+    errs.append("missing plans_dir")
+gr = doc.get("guideline_refs")
+if gr is not None and not isinstance(gr, dict):
+    errs.append("guideline_refs is not a mapping")
+tools = doc.get("tools")
+if tools is not None and not isinstance(tools, dict):
+    errs.append("tools is not a mapping")
+if errs:
+    sys.stderr.write("; ".join(errs))
+    sys.exit(1)
+PYEOF
+)" || CFG_RC=$?
+  if [ $CFG_RC -eq 0 ]; then
+    PASSED+=("[$FN/$AGENT/config.yaml] valid (schema)")
+  elif [ $CFG_RC -eq 2 ]; then
+    PASSED+=("[$FN/$AGENT/config.yaml] present (schema not validated, pyyaml missing)")
+  else
+    FAILURES+=("[$FN/$AGENT/config.yaml] $CFG_MSG")
+    FAILURES+=("  → Suggested fix: open the file and ensure it is a single YAML mapping with 'agent: $FN/$AGENT', 'plans_dir', a 'guideline_refs:' mapping, and a 'tools:' mapping (may be empty)")
+  fi
+else
+  PASSED+=("[$FN/$AGENT/config.yaml] present (schema not validated, python3 missing)")
+fi
+
 # .mcp.json valid JSON
 if [ ! -f "$AGENT_DIR/.mcp.json" ]; then
   WARNINGS+=("[$FN/$AGENT/.mcp.json] missing (no agent-scoped MCPs configured)")
@@ -168,53 +232,18 @@ else
   PASSED+=("[$FN/$AGENT/playbook/] present")
 fi
 
-# projects/_template/ exists
-if [ ! -d "$AGENT_DIR/projects/_template" ]; then
-  FAILURES+=("[$FN/$AGENT/projects/_template/] missing — new instances cannot be created without it")
-  FAILURES+=("  → Suggested fix: rebuild via 'bash scripts/new-agent.sh $FN $AGENT' (will fail if exists; manually copy from gtm/sdr/projects/_template/ as reference)")
-else
-  PASSED+=("[$FN/$AGENT/projects/_template/] present")
-fi
-
-# === Each instance ===
-INSTANCES=()
-while IFS= read -r path; do
-  INSTANCES+=("$path")
-done < <(find "$AGENT_DIR/projects" -maxdepth 1 -mindepth 1 -type d -not -name '_template' 2>/dev/null || true)
-
-for inst in "${INSTANCES[@]}"; do
-  REL="${inst#$ROOT/}"
-  PROJECT_NAME=$(basename "$inst")
-
-  CONFIG="$inst/config/default.yaml"
-  if [ ! -f "$CONFIG" ]; then
-    FAILURES+=("[$REL/config/default.yaml] missing")
-  else
-    if command -v python3 >/dev/null 2>&1; then
-      if ! python3 -c "import yaml; list(yaml.safe_load_all(open('$CONFIG')))" 2>/dev/null; then
-        FAILURES+=("[$REL/config/default.yaml] YAML parse error")
-      else
-        DECLARED=$(python3 -c "import yaml; docs = list(yaml.safe_load_all(open('$CONFIG'))); print((docs[0] or {}).get('project', ''))" 2>/dev/null || echo "")
-        if [ "$DECLARED" != "$PROJECT_NAME" ]; then
-          FAILURES+=("[$REL/config/default.yaml] project field '$DECLARED' doesn't match folder '$PROJECT_NAME'")
-        else
-          PASSED+=("[$REL/config/default.yaml] valid")
-        fi
-      fi
-    fi
-  fi
-
-  for d in log/runs log/feedback playbook; do
-    if [ ! -d "$inst/$d" ]; then
-      WARNINGS+=("[$REL/$d/] missing")
-    fi
-  done
-
-  if [ ! -f "$inst/asset-references.md" ]; then
-    WARNINGS+=("[$REL/asset-references.md] missing")
+# Flat-shape directories
+for d in logs/runs logs/feedback pending; do
+  if [ ! -d "$AGENT_DIR/$d" ]; then
+    WARNINGS+=("[$FN/$AGENT/$d/] missing")
   fi
 done
 
+# asset-references.md at agent root
+if [ ! -f "$AGENT_DIR/asset-references.md" ]; then
+  WARNINGS+=("[$FN/$AGENT/asset-references.md] missing")
+fi
+
 # === Status ===
 if [ ${#FAILURES[@]} -gt 0 ]; then
   STATUS="fail"
@@ -265,7 +294,6 @@ N_PASS=${#PASSED[@]}
   echo "- $N_PASS passed"
   echo "- $N_WARN warnings"
   echo "- $N_FAIL failures"
-  echo "- ${#INSTANCES[@]} instance(s) audited"
   echo ""
   if [ $N_FAIL -gt 0 ]; then
     echo "## Failures"
@@ -291,7 +319,6 @@ N_PASS=${#PASSED[@]}
 
 echo "Audit: $FN/$AGENT — $STATUS"
 echo "  Passed: $N_PASS, Warnings: $N_WARN, Failures: $N_FAIL"
-echo "  Instances audited: ${#INSTANCES[@]}"
 [ $N_FAIL -gt 0 ] && {
   echo "Failures:"
   for line in "${FAILURES[@]}"; do echo "  $line"; done

package/templates/scaffold/scripts/audit-repo.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# audit-repo.sh — full repo audit; runs project + agent audits, plus repo-level checks
+# audit-repo.sh — full workspace audit; runs agent audits and repo-level checks
 # Usage: bash scripts/audit-repo.sh
 
 set -euo pipefail
@@ -51,30 +51,34 @@ for f in CLAUDE.md conventions.md README.md; do
   fi
 done
 
-# Build a regex of registered functions for matching grandparent dirs.
-REGISTERED_FNS_PIPE=$(read_functions 2>/dev/null | tr '\n' '|' | sed 's/|$//')
+# config/project.yaml — workspace identity (v1 shape)
+if [ ! -f "$ROOT/config/project.yaml" ]; then
+  REPO_FAILURES+=("[config/project.yaml] missing — workspace identity required")
+elif command -v python3 >/dev/null 2>&1; then
+  if ! python3 -c "import yaml; yaml.safe_load(open('$ROOT/config/project.yaml'))" 2>/dev/null; then
+    REPO_FAILURES+=("[config/project.yaml] YAML parse error")
+  else
+    REPO_PASSED+=("[config/project.yaml] valid")
+  fi
+fi
 
-# Find orphaned instances (instance folder exists but agent doesn't)
-ORPHANS=()
-while IFS= read -r path; do
-  ORPHANS+=("$path")
-done < <(find "$ROOT" -type d -path "*/projects/*" -not -path "*/projects/_template*" -not -path "*/_archive/*" 2>/dev/null | while read p; do
-  PARENT=$(dirname $(dirname "$p"))
-  if [ -d "$PARENT" ] && [ ! -f "$PARENT/agent.md" ]; then
-    # This is a project folder under a non-agent — that's actually projects/ root
-    # We only care about instances: <fn>/<agent>/projects/<proj>/ where agent.md is missing
-    GRANDPARENT=$(dirname "$PARENT")
-    GP_NAME=$(basename "$GRANDPARENT")
-    if [ -n "$REGISTERED_FNS_PIPE" ] && echo "$GP_NAME" | grep -qE "^($REGISTERED_FNS_PIPE)\$"; then
-      echo "$p"
+# guidelines/ — cross-agent substrate
+if [ ! -d "$ROOT/guidelines" ]; then
+  REPO_FAILURES+=("[guidelines/] missing — workspace substrate dir required")
+else
+  REPO_PASSED+=("[guidelines/] present")
+  for f in voice.md messaging.md brand-book.md asset-links.md; do
+    if [ ! -f "$ROOT/guidelines/$f" ]; then
+      REPO_WARNINGS+=("[guidelines/$f] missing — required substrate file")
     fi
+  done
+  if [ ! -d "$ROOT/guidelines/icps" ] || [ -z "$(find "$ROOT/guidelines/icps" -maxdepth 1 -name '*.md' -type f 2>/dev/null | head -1)" ]; then
+    REPO_WARNINGS+=("[guidelines/icps/] empty or missing — at least one persona file required")
   fi
-done)
+fi
 
-for orphan in "${ORPHANS[@]:-}"; do
-  REL="${orphan#$ROOT/}"
-  REPO_WARNINGS+=("[$REL] orphaned instance — parent agent has no agent.md")
-done
+# Build a regex of registered functions for matching grandparent dirs.
+REGISTERED_FNS_PIPE=$(read_functions 2>/dev/null | tr '\n' '|' | sed 's/|$//')
 
 # Registered function should have a folder
 while IFS= read -r fn; do
@@ -109,7 +113,7 @@ if [ -f "$ENV_EXAMPLE" ]; then
 fi
 
 # Function-shaped top-level dirs not in the registry
-KNOWN_NON_FUNCTIONS="dreamer chief-of-staff projects scripts logs _archive"
+KNOWN_NON_FUNCTIONS="dreamer chief-of-staff scripts logs _archive"
 for dir in "$ROOT"/*/; do
   basename=$(basename "$dir")
   [[ "$basename" == .* ]] && continue
@@ -123,25 +127,6 @@ for dir in "$ROOT"/*/; do
   fi
 done
 
-# === Run audit-project for each project ===
-PROJECTS=()
-while IFS= read -r path; do
-  PROJECTS+=("$path")
-done < <(find "$ROOT/projects" -maxdepth 1 -mindepth 1 -type d -not -name '_template' 2>/dev/null || true)
-
-PROJECT_RESULTS=()
-for proj_path in "${PROJECTS[@]:-}"; do
-  PROJ=$(basename "$proj_path")
-  RESULT=$(bash "$ROOT/scripts/audit-project.sh" "$PROJ" 2>&1 | head -5 || echo "  (audit failed)")
-  PROJECT_RESULTS+=("### $PROJ")
-  PROJECT_RESULTS+=("\`\`\`")
-  while IFS= read -r line; do
-    PROJECT_RESULTS+=("$line")
-  done <<< "$RESULT"
-  PROJECT_RESULTS+=("\`\`\`")
-  PROJECT_RESULTS+=("")
-done
-
 # === Run audit-agent for each agent ===
 AGENTS=()
 while IFS= read -r fn; do
@@ -187,7 +172,6 @@ fi
   echo "# Repo Audit"
   echo ""
   echo "## Summary"
-  echo "- Projects audited: ${#PROJECTS[@]}"
   echo "- Agents audited: ${#AGENTS[@]}"
   echo "- Repo-level passed: ${#REPO_PASSED[@]}"
   echo "- Repo-level warnings: ${#REPO_WARNINGS[@]}"
@@ -214,12 +198,6 @@ fi
     done
     echo ""
   fi
-  echo "## Project audits (summaries)"
-  echo ""
-  for line in "${PROJECT_RESULTS[@]:-}"; do
-    echo "$line"
-  done
-  echo ""
   echo "## Agent audits (summaries)"
   echo ""
   for line in "${AGENT_RESULTS[@]:-}"; do
@@ -231,7 +209,7 @@ fi
 
 # Print summary
 echo "Repo audit: $STATUS"
-echo "  Projects: ${#PROJECTS[@]} | Agents: ${#AGENTS[@]}"
+echo "  Agents: ${#AGENTS[@]}"
 echo "  Repo-level: ${#REPO_PASSED[@]} passed, ${#REPO_WARNINGS[@]} warnings, ${#REPO_FAILURES[@]} failures"
 [ ${#REPO_FAILURES[@]} -gt 0 ] && {
   echo "Repo failures:"

package/templates/scaffold/scripts/create-function.sh

@@ -215,7 +215,7 @@ if [ "$WITH_EXPERT" = "true" ]; then
 This is a stub. Fill in the expert system prompt for this function.
 
 Experts shape SUBSTRATE (project guidelines), not artifacts. They critique
-and generate guideline files in \`projects/<project>/guidelines/\`.
+and generate guideline files in \`guidelines/\` at the workspace root.
 
 Required sections (see other EXPERT.md files for examples once they exist):
 - Identity (1 paragraph)

package/templates/scaffold/scripts/lib/README.md

@@ -10,7 +10,7 @@ Conventions:
 ## Current inhabitants
 
 - `functions.sh` — read/validate the function registry at `.config/functions.yaml`. Pure bash + falls back to `python3` + `pyyaml` when available for safer YAML parsing.
-- `bindings-prompt.sh` — interactive prompts for per-tool bindings during `new-agent-instance.sh`. Requires `python3` + `pyyaml` for the YAML output rendering (falls back gracefully when unavailable).
+- `bindings-prompt.sh` — **disabled in v1.0**. Phase 2 will rebuild this around the env-merge loader (config.yaml `tools:` metadata + `/.env` values). Until then, invocation aborts with manual-configuration instructions (edit agent.md `## Tools and bindings` → mirror the YAML block into `<agent>/config.yaml` → add env-var values to `/.env`). The file remains in the tarball + executable so smoke continues to assert presence; the runtime behavior is the guard message.
 
 Example future additions:
 - `lib/lesson.sh` — read/write lesson files, validate schema