pi-soly 1.13.5 → 1.14.0

package/workflows/quick.ts

@@ -36,7 +36,7 @@ export function showStatus(
 	config?: SolyConfig,
 ): void {
 	if (!state.exists) {
-		ui.notify("soly: no .soly/ directory in cwd", "error");
+		ui.notify("soly: no .agents/ directory in cwd", "error");
 		return;
 	}
 	const maxPhases = config?.display.maxPhasesInStatus ?? 20;
@@ -122,7 +122,7 @@ const DECISIONS_TABLE_ROW = /^\|\s*([^|]+)\s*\|\s*([^|]+)\s*\|\s*([^|]+)\s*\|\s*
 
 export function showLog(cmd: SolyCommand, state: SolyState, ui: QuickUI): void {
 	if (!state.exists) {
-		ui.notify("soly log: no .soly/ directory in cwd", "error");
+		ui.notify("soly log: no .agents/ directory in cwd", "error");
 		return;
 	}
 
@@ -214,7 +214,7 @@ export async function showDiff(
 	state: SolyState,
 	ui: QuickUI,
 ): Promise<void> {
-	// Graceful without .soly/: use cwd as project root, skip the .soly/ filter
+	// Graceful without .agents/: use cwd as project root, skip the .agents/ filter
 	const projectRoot = state.solyDir ? path.dirname(state.solyDir) : process.cwd();
 	const solyDir = state.solyDir; // may be empty when run outside a soly project
 
@@ -222,7 +222,7 @@ export async function showDiff(
 	const status = await safeExec("git", ["status", "--short", "--branch"], projectRoot);
 	// 2. git diff (tracked changes, no untracked)
 	const diff = await safeExec("git", ["diff", "--stat"], projectRoot);
-	// 3. uncommitted .soly/ file changes (since last commit)
+	// 3. uncommitted .agents/ file changes (since last commit)
 	const solyChanges = await safeExec(
 		"git",
 		["status", "--short", "--", solyDir],
@@ -230,7 +230,7 @@ export async function showDiff(
 	);
 
 	const out: string[] = [];
-	out.push(state.exists ? "=== soly diff ===" : "=== git diff (no .soly/ in cwd) ===");
+	out.push(state.exists ? "=== soly diff ===" : "=== git diff (no .agents/ in cwd) ===");
 	out.push("");
 
 	if (status.code !== 0) {
@@ -246,10 +246,10 @@ export async function showDiff(
 		}
 		if (solyDir) {
 			if (solyChanges.stdout.trim()) {
-				out.push("uncommitted .soly/ changes:");
+				out.push("uncommitted .agents/ changes:");
 				out.push(solyChanges.stdout.trim());
 			} else {
-				out.push("uncommitted .soly/ changes: (none)");
+				out.push("uncommitted .agents/ changes: (none)");
 			}
 		}
 	}

package/workflows/resume.ts

@@ -7,11 +7,11 @@
 // session context from the last handoff.
 //
 // Reads:
-//   - .soly/HANDOFF.json       (machine-readable state, written by pause/compact)
-//   - .soly/.continue-here.md  (human-readable context, written by pause/compact)
+//   - .agents/HANDOFF.json       (machine-readable state, written by pause/compact)
+//   - .agents/.continue-here.md  (human-readable context, written by pause/compact)
 //
 // If neither file exists, falls back to a "no prior handoff" message that
-// tells the LLM to load context from .soly/STATE.md + ROADMAP.md normally.
+// tells the LLM to load context from .agents/STATE.md + ROADMAP.md normally.
 // =============================================================================
 
 import * as fs from "node:fs";
@@ -73,7 +73,7 @@ function formatListSection(label: string, items: string[] | undefined): string {
 function formatHandoffSummary(h: HandoffJson): string {
 	const lines: string[] = [];
 
-	lines.push("=== From .soly/HANDOFF.json ===");
+	lines.push("=== From .agents/HANDOFF.json ===");
 	if (h.generated_at) lines.push(`  generated_at: ${h.generated_at}`);
 	if (h.milestone) lines.push(`  milestone: ${h.milestone}${h.milestone_name ? ` — ${h.milestone_name}` : ""}`);
 	if (h.status) lines.push(`  status: ${h.status}`);
@@ -112,7 +112,7 @@ export function buildResumeTransform(cmd: SolyCommand, state: SolyState): Resume
 		return {
 			handled: true,
 			transformedText:
-				`soly resume: no .soly/ directory in cwd (${state.solyDir || "<cwd>"}) — nothing to resume.\n` +
+				`soly resume: no .agents/ directory in cwd (${state.solyDir || "<cwd>"}) — nothing to resume.\n` +
 				`Initialize a soly project first, or run \`soly pause\` later to create handoff files.`,
 		};
 	}
@@ -149,24 +149,24 @@ export function buildResumeTransform(cmd: SolyCommand, state: SolyState): Resume
 	}
 
 	if (!handoff && !continueMd) {
-		// No prior handoff — fall back to loading from .soly/STATE.md directly.
+		// No prior handoff — fall back to loading from .agents/STATE.md directly.
 		const fallbackScope = phaseFilter != null
 			? `Focus: phase ${phaseFilter}.`
 			: "Scope: full project.";
 		return {
 			handled: true,
 			transformedText:
-				`soly resume: no handoff files found (looked for .soly/HANDOFF.json and .soly/.continue-here.md).\n` +
-				`No prior \`soly pause\` was run — loading context from .soly/STATE.md and .soly/ROADMAP.md directly.\n\n` +
+				`soly resume: no handoff files found (looked for .agents/HANDOFF.json and .agents/.continue-here.md).\n` +
+				`No prior \`soly pause\` was run — loading context from .agents/STATE.md and .agents/ROADMAP.md directly.\n\n` +
 				`${fallbackScope}\n\n` +
-				`Read .soly/STATE.md (Current Position, Decisions, Blockers sections) and .soly/ROADMAP.md.\n` +
+				`Read .agents/STATE.md (Current Position, Decisions, Blockers sections) and .agents/ROADMAP.md.\n` +
 				`Summarize: where the project is, what's next, what's blocking. Then ask the user what to focus on first.`,
 		};
 	}
 
 	const handoffBlock = handoff ? formatHandoffSummary(handoff) : "(no HANDOFF.json found)";
 	const continueBlock = continueMd
-		? `\n=== From .soly/.continue-here.md ===\n${continueMd.trim()}\n`
+		? `\n=== From .agents/.continue-here.md ===\n${continueMd.trim()}\n`
 		: "";
 
 	const focusLine = phaseFilter != null
@@ -182,10 +182,10 @@ ${continueBlock}
 
 === Resume protocol ===
 
-1. **Read .soly/docs/ first** — the project's 0-point intent. Pickup is meaningless without knowing what the user is building toward.
-2. Read .soly/STATE.md to confirm current position (the handoff may be stale).
-3. Read .soly/ROADMAP.md and any CONTEXT.md / RESEARCH.md for the active phase.
-4. Compare handoff's "work remaining" with the actual repo state (git status, recent commits, .soly/ files).
+1. **Read .agents/docs/ first** — the project's 0-point intent. Pickup is meaningless without knowing what the user is building toward.
+2. Read .agents/STATE.md to confirm current position (the handoff may be stale).
+3. Read .agents/ROADMAP.md and any CONTEXT.md / RESEARCH.md for the active phase.
+4. Compare handoff's "work remaining" with the actual repo state (git status, recent commits, .agents/ files).
 5. Produce a one-screen "Where we are" summary:
    - current phase + plan
    - what's actually been done (verified via filesystem / git)

package/workflows-data/discuss-phase.md

@@ -10,7 +10,7 @@ canonical CONTEXT.md. For design/architecture forks you may reach for
 markdown is background context, not a strict protocol.</purpose>
 
 <path_discipline>
-**All soly-managed files live under `.soly/`.** CONTEXT.md, RESEARCH.md, and the discuss checkpoint all go in `.soly/phases/<NN>-<slug>/`. Never write these to the project root. Use absolute paths.
+**All soly-managed files live under `.agents/`.** CONTEXT.md, RESEARCH.md, and the discuss checkpoint all go in `.agents/phases/<NN>-<slug>/`. Never write these to the project root. Use absolute paths.
 
 The iteration context file (path given by the parent in the task prompt) is your single source of truth for intent, STATE, ROADMAP, and any existing phase artifacts. Read it FIRST.
 </path_discipline>
@@ -36,7 +36,7 @@ The iteration context file (path given by the parent in the task prompt) is your
 **Resume:** if a checkpoint file exists, the parent detects it and tells you to resume from where the prior session left off. Acknowledge locked decisions at the top of your output, then continue with the next un-answered gray area.
 </interactive_flow>
 
-<read_first>`.soly/docs/` (INTENT, 0-point) · `.soly/STATE.md` · `.soly/ROADMAP.md` · `${PHASE_DIR}/*-CONTEXT.md` if exists (refine, don't re-derive) · `${PHASE_DIR}/*-DISCUSS-CHECKPOINT.json` if exists (resume from `areas_completed`)</read_first>
+<read_first>`.agents/docs/` (INTENT, 0-point) · `.agents/STATE.md` · `.agents/ROADMAP.md` · `${PHASE_DIR}/*-CONTEXT.md` if exists (refine, don't re-derive) · `${PHASE_DIR}/*-DISCUSS-CHECKPOINT.json` if exists (resume from `areas_completed`)</read_first>
 
 <philosophy>
 **User = visionary. Worker = builder.** The user knows: how it should feel, what's essential vs nice-to-have, specific references. The user doesn't know (don't ask): codebase patterns, technical risks, implementation approach, success metrics.
@@ -90,7 +90,7 @@ PHASE=$1
 # Worker subagent inherits the parent's cwd (the project root), so
 # `pwd` IS the project root. The previous `cd .. && pwd` was a bug.
 PROJECT_ROOT="$(pwd)"
-SOLY_DIR="$PROJECT_ROOT/.soly"
+SOLY_DIR="$PROJECT_ROOT/.agents"
 PHASE_DIR=$(ls -d "$SOLY_DIR/phases/"*"-$PHASE-"* 2>/dev/null | head -1) || { echo "Phase $PHASE not found" >&2; exit 1; }
 PADDED_PHASE=$(printf "%02d" "$(echo "$PHASE" | grep -oE '^[0-9]+' | sed 's/^0*//')")
 PHASE_SLUG=$(basename "$PHASE_DIR")
@@ -137,7 +137,7 @@ If you cannot answer from `.continue-here.md`, return `## Clarifications Needed`
 [ -f "$SOLY_DIR/DECISIONS-INDEX.md" ] && echo "DECISIONS-INDEX.md (prefer over per-phase if present)"
 ```
 
-Most-recent 3 prior `*-CONTEXT.md` files (prefer DECISIONS-INDEX if present). Extract `<decisions>`, `<specifics>`, and patterns (e.g., "user prefers minimal UI"). If `.soly/spikes/MANIFEST.md` or `.soly/sketches/MANIFEST.md` exist with `WRAPPED: true` frontmatter, read as validated findings.
+Most-recent 3 prior `*-CONTEXT.md` files (prefer DECISIONS-INDEX if present). Extract `<decisions>`, `<specifics>`, and patterns (e.g., "user prefers minimal UI"). If `.agents/spikes/MANIFEST.md` or `.agents/sketches/MANIFEST.md` exist with `WRAPPED: true` frontmatter, read as validated findings.
 
 **6. Cross-reference todos.** (Worker doesn't have `soly_todos`; use `bash` + `grep` with phase-domain keywords.)
 
@@ -217,9 +217,9 @@ Requirements locked by SPEC.md. Do not re-litigate.
 </decisions>
 
 <canonical_refs> <!-- MANDATORY -->
-- `.soly/docs/<file>` — <why>
-- `.soly/features/<feat>/README.md` — <why>
-- `.soly/contracts/<file>` — <why>
+- `.agents/docs/<file>` — <why>
+- `.agents/features/<feat>/README.md` — <why>
+- `.agents/contracts/<file>` — <why>
 - (no external docs referenced) <!-- only if literally none -->
 </canonical_refs>
 
@@ -289,8 +289,8 @@ Update after every round. Delete after `write_context` succeeds.
 <hard_rules>
 - No production code. Discussion/planning only.
 - No PLAN.md from this workflow — that's `soly plan`.
-- Don't assume missing intent. If `.soly/docs/` is silent, ask.
+- Don't assume missing intent. If `.agents/docs/` is silent, ask.
 - No scope creep. Deferred ideas → `<deferred_ideas>`, not decisions.
-- No subagents (you ARE one). No `.soly/rules/` edits.
+- No subagents (you ARE one). No `.agents/rules/` edits.
 - Return: structured output per output_protocol + checkpoint updates. Parent relays to user.
 </hard_rules>

package/workflows-data/execute-phase.md

@@ -3,12 +3,12 @@
 <purpose>Execute all plans in a phase, wave by wave. Per plan, follow `execute-plan.md` inline. Update STATE.md between plans. Generate a phase-level VERIFICATION.md at the end. You ARE the executor (`maxSubagentDepth: 1` is enforced — no sub-sub-agents). Checkpoint requests return a structured block; parent relays to user; next `soly execute <N>` resumes from `.execute-checkpoint.json`.</purpose>
 
 <path_discipline>
-**All soly-managed files live under `.soly/`.** Never write PLAN.md, CONTEXT.md, RESEARCH.md, SUMMARY.md, iteration files, or handoffs to the project root. All phase files go in `.soly/phases/<NN>-<slug>/`. Use absolute paths (or paths starting with `$SOLY_DIR`) — never bare relative names that could land in cwd.
+**All soly-managed files live under `.agents/`.** Never write PLAN.md, CONTEXT.md, RESEARCH.md, SUMMARY.md, iteration files, or handoffs to the project root. All phase files go in `.agents/phases/<NN>-<slug>/`. Use absolute paths (or paths starting with `$SOLY_DIR`) — never bare relative names that could land in cwd.
 
 The iteration context file (path given by the parent in the task prompt) is your single source of truth for intent, STATE, ROADMAP, and any existing phase artifacts. Read it FIRST, before any of your own `read` or `ls` calls.
 </path_discipline>
 
-<read_first>`.soly/STATE.md` (single source of truth for "where am I") · `.soly/ROADMAP.md` (phase goal + reqs) · `.soly/docs/` (INTENT, re-read before each plan) · the phase directory: list PLAN.md sorted, plus any SUMMARY.md / CONTEXT.md / RESEARCH.md / `.execute-checkpoint.json`. If `.soly/` missing → stop + error.</read_first>
+<read_first>`.agents/STATE.md` (single source of truth for "where am I") · `.agents/ROADMAP.md` (phase goal + reqs) · `.agents/docs/` (INTENT, re-read before each plan) · the phase directory: list PLAN.md sorted, plus any SUMMARY.md / CONTEXT.md / RESEARCH.md / `.execute-checkpoint.json`. If `.agents/` missing → stop + error.</read_first>
 
 <core_principle>
 **Orchestrate, don't re-specify.** Each PLAN.md is the contract; `execute-plan.md` is the per-plan protocol. This file adds: wave grouping, state transitions between plans, phase-level aggregation (VERIFICATION.md), safe resumption from partial state. The full per-plan steps live in `execute-plan.md` — read it once, then apply per plan.
@@ -28,7 +28,7 @@ PHASE="$1"
 # would fall back to the `write` tool with a relative path, polluting
 # the project root).
 PROJECT_ROOT="$(pwd)"
-SOLY_DIR="$PROJECT_ROOT/.soly"
+SOLY_DIR="$PROJECT_ROOT/.agents"
 PHASE_DIR=$(ls -d "$SOLY_DIR/phases/"*"-$PHASE-"* 2>/dev/null | head -1) || { echo "Phase $PHASE not found" >&2; exit 1; }
 PADDED_PHASE=$(printf "%02d" "$(echo "$PHASE" | grep -oE '^[0-9]+' | sed 's/^0*//')")
 PHASE_SLUG=$(basename "$PHASE_DIR")
@@ -190,7 +190,7 @@ phase: <N>  phase_slug: <slug>  status: pending  generated: <ISO>
 </process>
 
 <hard_rules>
-- No `.soly/rules/` edits. No subagents (`maxSubagentDepth: 1`).
+- No `.agents/rules/` edits. No subagents (`maxSubagentDepth: 1`).
 - No silent skip of partial-state plans — surface and stop.
 - No flipping VERIFICATION.md to `passed` yourself.
 - No silent architectural decisions — use `execute-plan.md`'s Rule 4 + checkpoint.

package/workflows-data/execute-plan.md

@@ -3,12 +3,12 @@
 <purpose>Execute one PLAN.md, produce a matching SUMMARY.md, update STATE.md/ROADMAP.md. Single worker — no sub-subagents.</purpose>
 
 <path_discipline>
-**All soly-managed files live under `.soly/`.** Never write PLAN.md, CONTEXT.md, RESEARCH.md, SUMMARY.md, iteration files, or handoffs to the project root. All phase files go in `.soly/phases/<NN>-<slug>/`. Use absolute paths (or paths starting with `$SOLY_DIR`) — never bare relative names that could land in cwd.
+**All soly-managed files live under `.agents/`.** Never write PLAN.md, CONTEXT.md, RESEARCH.md, SUMMARY.md, iteration files, or handoffs to the project root. All phase files go in `.agents/phases/<NN>-<slug>/`. Use absolute paths (or paths starting with `$SOLY_DIR`) — never bare relative names that could land in cwd.
 
 The iteration context file (path given by the parent in the task prompt) is your single source of truth for intent, STATE, ROADMAP, phase CONTEXT/RESEARCH, prior SUMMARYs, and (section 6) the current PLAN. Read it FIRST.
 </path_discipline>
 
-<read_first>`.soly/STATE.md` · `.soly/ROADMAP.md` · `PLAN.md` (the contract) · `<phase>-CONTEXT.md` if exists (honor user decisions) · `<phase>-RESEARCH.md` if exists (use chosen libs/patterns). If `.soly/` missing → stop + error.</read_first>
+<read_first>`.agents/STATE.md` · `.agents/ROADMAP.md` · `PLAN.md` (the contract) · `<phase>-CONTEXT.md` if exists (honor user decisions) · `<phase>-RESEARCH.md` if exists (use chosen libs/patterns). If `.agents/` missing → stop + error.</read_first>
 
 <atomic_close_out>
 **Only legal close-out order:** `production-code commit(s) → SUMMARY commit → STATE/ROADMAP update`.
@@ -24,7 +24,7 @@ PHASE="$1"; PLAN="$2"  # PLAN optional — defaults to next unfinished
 # Worker subagent inherits the parent's cwd (the project root), so
 # `pwd` IS the project root. The previous `cd .. && pwd` was a bug.
 PROJECT_ROOT="$(pwd)"
-SOLY_DIR="$PROJECT_ROOT/.soly"
+SOLY_DIR="$PROJECT_ROOT/.agents"
 PHASE_DIR=$(ls -d "$SOLY_DIR/phases/"*"-$PHASE-"* 2>/dev/null | head -1) || { echo "Phase $PHASE not found" >&2; exit 1; }
 PADDED_PHASE=$(printf "%02d" "$(echo "$PHASE" | grep -oE '^[0-9]+' | sed 's/^0*//')")
 PHASE_SLUG=$(basename "$PHASE_DIR")
@@ -60,7 +60,7 @@ PARTIAL_PLAN=$([ "$COMMIT_COUNT" -gt 0 ] && [ "$SUMMARY_EXISTS" = false ] && ech
 **5. Execute tasks in order.** Per task:
 
 1. **Read first** — open every `<read_first>` file.
-2. **Implement** — minimal correct change, follow project patterns. No speculative scaffolding. No `.soly/rules/` edits.
+2. **Implement** — minimal correct change, follow project patterns. No speculative scaffolding. No `.agents/rules/` edits.
 3. **Verify acceptance criteria (HARD GATE):**
    - Run the grep/file-check/CLI for each criterion in `<acceptance_criteria>`.
    - Log PASS/FAIL with output. If ANY fails → fix immediately, re-run ALL.
@@ -123,7 +123,7 @@ Can't talk to user directly. Stop, return structured block, parent relays.
 
 **9. Pre-commit hook failure:**
 1. `git commit` fails with hook error. 2. Read error — names hook + what failed. 3. Fix (type/lint/secret). 4. `git add` fixed. 5. Retry. 6. Budget 1–2 cycles per commit. If still failing → `type: "human-action"` checkpoint with hook output.
-**Do NOT use `--no-verify`** unless project's `.soly/docs/` or ROADMAP.md explicitly opts out.
+**Do NOT use `--no-verify`** unless project's `.agents/docs/` or ROADMAP.md explicitly opts out.
 
 **10. Verification failure gate:** 1st retry (hooks flake) → 2nd retry (fix obvious cause) → 3rd retry (apply deviation rules) → 3+ fails → `type: "decision"` checkpoint, STOP.
 
@@ -212,7 +212,7 @@ git commit -m "chore(${PADDED_PHASE}-${PLAN_NUM}): complete plan <N>"
 - Bump `current_plan` in "Current Position".
 - Add `key-decisions` to "Decisions" table (skip if trivial).
 - Update `last_updated`.
-- Keep < 150 lines — archive long-form to `.soly/DECISIONS-INDEX.md` if it grows.
+- Keep < 150 lines — archive long-form to `.agents/DECISIONS-INDEX.md` if it grows.
 
 **Update ROADMAP.md** — phase's progress row: increment completed plan count; status → `In Progress` (more plans) or `Complete` (last) with date.
 
@@ -222,7 +222,7 @@ git commit -m "chore(${PADDED_PHASE}-${PLAN_NUM}): complete plan <N>"
 REQUIREMENTS=$(grep -A1 "^requirements:" "$PLAN_PATH" | tail -1 | sed -E 's/.*\[([^]]+)\].*/\1/' | tr ',' ' ')
 ```
 
-For each ID, find line in `.soly/REQUIREMENTS.md`, flip status to `Complete`.
+For each ID, find line in `.agents/REQUIREMENTS.md`, flip status to `Complete`.
 
 **15. Return:**
 
@@ -241,7 +241,7 @@ For each ID, find line in `.soly/REQUIREMENTS.md`, flip status to `Complete`.
 </process>
 
 <hard_rules>
-- No `.soly/rules/` edits. No `.soly/docs/` edits without explicit user decision in conversation.
+- No `.agents/rules/` edits. No `.agents/docs/` edits without explicit user decision in conversation.
 - No subagents (you ARE one). `maxSubagentDepth: 1` is enforced.
 - **Never skip `<acceptance_criteria>` HARD GATE.** Not optional.
 - **Never emit narrative between SUMMARY `write` and `git commit`** (truncation is a known failure mode).

package/workflows-data/execute-task.md

@@ -1,14 +1,14 @@
 # Execute Task
 
-<purpose>Execute ONE task (atomic unit — a feature slice, one endpoint, one page, one contract wire). Produce SUMMARY.md. Tasks live under `.soly/features/<feature>/tasks/<task-id>/` with PLAN.md as the contract.</purpose>
+<purpose>Execute ONE task (atomic unit — a feature slice, one endpoint, one page, one contract wire). Produce SUMMARY.md. Tasks live under `.agents/features/<feature>/tasks/<task-id>/` with PLAN.md as the contract.</purpose>
 
 <path_discipline>
-**All soly-managed files live under `.soly/`.** Never write PLAN.md, SUMMARY.md, iteration files, or handoffs to the project root. Task files go in `.soly/features/<feature>/tasks/<task-id>/`. Use absolute paths — never bare relative names that could land in cwd.
+**All soly-managed files live under `.agents/`.** Never write PLAN.md, SUMMARY.md, iteration files, or handoffs to the project root. Task files go in `.agents/features/<feature>/tasks/<task-id>/`. Use absolute paths — never bare relative names that could land in cwd.
 
 The iteration context file (path given by the parent in the task prompt) is your single source of truth for intent, STATE, the feature README, prior task SUMMARYs, and the current task PLAN. Read it FIRST.
 </path_discipline>
 
-<read_first>`.soly/STATE.md` · `.soly/docs/` (INTENT, 0-point) · `.soly/features/<feature>/README.md` · `PLAN.md` (the contract) · `.soly/contracts/*` if PLAN.md references it. If `.soly/features/` or task dir missing → error + stop, do not invent paths.</read_first>
+<read_first>`.agents/STATE.md` · `.agents/docs/` (INTENT, 0-point) · `.agents/features/<feature>/README.md` · `PLAN.md` (the contract) · `.agents/contracts/*` if PLAN.md references it. If `.agents/features/` or task dir missing → error + stop, do not invent paths.</read_first>
 
 <task_frontmatter>
 PLAN.md frontmatter (executor must respect all fields; **flag** incomplete ones in your report, don't silently fill):
@@ -46,13 +46,13 @@ STATUS=$(awk '/^---$/{c++; next} c==1{print}' "$TASK_DIR/PLAN.md" | grep -E '^st
 
 If not → return `## Blocker` to parent, stop. Do NOT start a blocked task.
 
-**2. Read intent + feature context.** **0-POINT CHECK** — the iteration context file (path given in the task prompt) already contains the intent docs as a summary, the feature README, prior task SUMMARYs, and the current task PLAN. Use that. If intent and PLAN.md conflict, flag it. Read `.soly/contracts/*` (if it exists) only if the task touches API surfaces.
+**2. Read intent + feature context.** **0-POINT CHECK** — the iteration context file (path given in the task prompt) already contains the intent docs as a summary, the feature README, prior task SUMMARYs, and the current task PLAN. Use that. If intent and PLAN.md conflict, flag it. Read `.agents/contracts/*` (if it exists) only if the task touches API surfaces.
 
 **3. Execute** with standard worker self-audit:
 
 1. Write code.
 2. Run build / typecheck / lint — **0 warnings**.
-3. Cross-check diff against `.soly/rules/coding/*` (or `.editorconfig`).
+3. Cross-check diff against `.agents/rules/coding/*` (or `.editorconfig`).
 4. **Rule gap?** Invoke the project's rule-authoring skill (`analyzer-coach` or equivalent) — it proposes an `.editorconfig` entry, a coding-rule doc addition, or a custom-analyzer rule. Loop until clean, max 3 iterations.
 5. Commit production-code changes (one or more commits).
 
@@ -101,7 +101,7 @@ You may combine into one commit, but the SUMMARY must be on disk before the fron
 </process>
 
 <hard_rules>
-- No `.soly/rules/` edits. No subagents (you ARE one).
+- No `.agents/rules/` edits. No subagents (you ARE one).
 - No starting tasks with un-`done` `depends-on:`.
 - If rule gap → add via the rule-authoring skill. **No silent workarounds** (`#pragma`, `severity = none`).
 - Return: changed files, commands + exit codes, validation evidence, surprises, decisions needing parent approval.
@@ -112,5 +112,5 @@ You may combine into one commit, but the SUMMARY must be on disk before the fron
 </interactive_rules_out_of_scope>
 
 <dual_mode_note>
-Project may also have `.soly/phases/` (phase-based layout, distinct from task-based). You are only responsible for this task. Don't touch phases. Don't modify ROADMAP.md or STATE.md beyond what your close-out requires (typically nothing for tasks — the parent updates those).
+Project may also have `.agents/phases/` (phase-based layout, distinct from task-based). You are only responsible for this task. Don't touch phases. Don't modify ROADMAP.md or STATE.md beyond what your close-out requires (typically nothing for tasks — the parent updates those).
 </dual_mode_note>

package/workflows-data/pause-work.md

@@ -1,36 +1,36 @@
 # Pause Work
 
-<purpose>Create `.soly/HANDOFF.json` (machine-readable) and a `.continue-here.md` (human-readable) to preserve work state across sessions. `soly resume` consumes both.</purpose>
+<purpose>Create `.agents/HANDOFF.json` (machine-readable) and a `.continue-here.md` (human-readable) to preserve work state across sessions. `soly resume` consumes both.</purpose>
 
-<read_first>.soly/STATE.md (current position) · the most recent `.soly/phases/*/SUMMARY.md` if any</read_first>
+<read_first>.agents/STATE.md (current position) · the most recent `.agents/phases/*/SUMMARY.md` if any</read_first>
 
 <process>
 
-**1. Detect context.** First match wins; nothing detectable → `.soly/.continue-here.md` (note ambiguity in `<current_state>`).
+**1. Detect context.** First match wins; nothing detectable → `.agents/.continue-here.md` (note ambiguity in `<current_state>`).
 
 ```bash
-phase=$(ls -t .soly/phases/*/PLAN.md 2>/dev/null | head -1)
+phase=$(ls -t .agents/phases/*/PLAN.md 2>/dev/null | head -1)
 phase_slug=$(echo "$phase" | grep -oP 'phases/\K[^/]+')
-spike=$(ls -td .soly/spikes/*/ 2>/dev/null | head -1)
-sketch=$(ls -td .soly/sketches/*/ 2>/dev/null | head -1)
-deliberation=$(ls .soly/deliberations/*.md 2>/dev/null | head -1)
+spike=$(ls -td .agents/spikes/*/ 2>/dev/null | head -1)
+sketch=$(ls -td .agents/sketches/*/ 2>/dev/null | head -1)
+deliberation=$(ls .agents/deliberations/*.md 2>/dev/null | head -1)
 ```
 
 | detected | handoff path |
 |---|---|
-| phase_slug | `.soly/phases/<phase_slug>/.continue-here.md` |
-| spike | `.soly/spikes/<spike_slug>/.continue-here.md` |
-| sketch | `.soly/sketches/<sketch_slug>/.continue-here.md` |
-| deliberation | `.soly/deliberations/.continue-here.md` |
-| (notes only) | `.soly/.continue-here.md` |
+| phase_slug | `.agents/phases/<phase_slug>/.continue-here.md` |
+| spike | `.agents/spikes/<spike_slug>/.continue-here.md` |
+| sketch | `.agents/sketches/<sketch_slug>/.continue-here.md` |
+| deliberation | `.agents/deliberations/.continue-here.md` |
+| (notes only) | `.agents/.continue-here.md` |
 
 **2. Gather state.** Walk the conversation + recent diffs. Collect: current position (phase/plan/task + paths), work done this session (artifacts, not aspirations), work remaining, decisions (only those future-you must not re-litigate), blockers, human actions pending (API keys, approvals, manual tests), background processes, uncommitted files (`git status --porcelain`), and blocking constraints (anti-patterns discovered through actual failure — each tagged `blocking` or `advisory`).
 
 If anything is ambiguous, return a `## Clarifications Needed` block — do not invent.
 
-**3. Check for false completions.** `grep -l "To be filled\|placeholder\|TBD" .soly/phases/*/*.md 2>/dev/null` — report matches as incomplete.
+**3. Check for false completions.** `grep -l "To be filled\|placeholder\|TBD" .agents/phases/*/*.md 2>/dev/null` — report matches as incomplete.
 
-**4. Write `.soly/HANDOFF.json`.** Timestamp via `date -u +"%Y-%m-%dT%H:%M:%SZ"` (no SDK).
+**4. Write `.agents/HANDOFF.json`.** Timestamp via `date -u +"%Y-%m-%dT%H:%M:%SZ"` (no SDK).
 
 ```json
 {
@@ -98,7 +98,7 @@ _If none, remove this section._
 
 ## Required Reading (in order)
 1. <doc> — <why>
-2. `.soly/METHODOLOGY.md` if it exists — project lenses
+2. `.agents/METHODOLOGY.md` if it exists — project lenses
 
 ## Infrastructure State
 - <service/env>: <state>
@@ -117,14 +117,14 @@ Specific enough that a fresh worker can resume without re-deriving from git hist
 
 **6. Commit:**
 ```bash
-git add .soly/HANDOFF.json <handoff-md-path>
+git add .agents/HANDOFF.json <handoff-md-path>
 git commit -m "chore(soly): pause work — create handoff"
 ```
 
 **7. Return:**
 ```
 Handoff created:
-  - .soly/HANDOFF.json
+  - .agents/HANDOFF.json
   - <handoff-md-path>
 State: <context>, <location>, task <x>/<m>, in_progress, <n> blockers (<m> human)
 Resume: `soly resume`
@@ -136,7 +136,7 @@ Resume: `soly resume`
 - No production code. Handoff only.
 - A summary with `TBD`/`placeholder`/`To be filled` is incomplete — report it.
 - `null` is JSON `null`, not the string `"null"`.
-- Do not modify `.soly/rules/`. Do not run subagents (you ARE one).
+- Do not modify `.agents/rules/`. Do not run subagents (you ARE one).
 - Commit message: `chore(soly): pause work — create handoff`.
 - Return: paths, state summary, blocker count, `soly resume` command.
 </hard_rules>

package/workflows-data/plan-phase.md

@@ -3,12 +3,12 @@
 <purpose>Produce one or more PLAN.md files for a phase — each a self-contained contract (requirements, must_haves, tasks with runnable acceptance criteria) the executor can run standalone. Pre-compute wave numbers encoding the dependency graph. Update STATE.md.</purpose>
 
 <path_discipline>
-**All soly-managed files live under `.soly/`.** Never write PLAN.md, CONTEXT.md, RESEARCH.md, SUMMARY.md, iteration files, or handoffs to the project root. All phase files go in `.soly/phases/<NN>-<slug>/`. Use absolute paths (or paths starting with `$SOLY_DIR`) — never bare relative names that could land in cwd.
+**All soly-managed files live under `.agents/`.** Never write PLAN.md, CONTEXT.md, RESEARCH.md, SUMMARY.md, iteration files, or handoffs to the project root. All phase files go in `.agents/phases/<NN>-<slug>/`. Use absolute paths (or paths starting with `$SOLY_DIR`) — never bare relative names that could land in cwd.
 
 The iteration context file (path given by the parent in the task prompt) is your single source of truth for intent, STATE, ROADMAP, and any existing phase artifacts. Read it FIRST, before any of your own `read` or `ls` calls.
 </path_discipline>
 
-<read_first>`.soly/docs/` (INTENT, 0-point) · `.soly/STATE.md` (current position) · `.soly/ROADMAP.md` (this phase's row) · `.soly/REQUIREMENTS.md` if exists · `<phase>-CONTEXT.md` if exists (user decisions from `soly discuss`) · `<phase>-RESEARCH.md` if exists (chosen libs/patterns) · up to 3 most recent prior `*-SUMMARY.md` (avoid re-implementing). If `.soly/` missing → stop + error.</read_first>
+<read_first>`.agents/docs/` (INTENT, 0-point) · `.agents/STATE.md` (current position) · `.agents/ROADMAP.md` (this phase's row) · `.agents/REQUIREMENTS.md` if exists · `<phase>-CONTEXT.md` if exists (user decisions from `soly discuss`) · `<phase>-RESEARCH.md` if exists (chosen libs/patterns) · up to 3 most recent prior `*-SUMMARY.md` (avoid re-implementing). If `.agents/` missing → stop + error.</read_first>
 
 <git_branch_invariant>
 **Do not create, rename, or switch git branches.** The branch was established at `soly discuss` and is owned by the user's git workflow. Verify the current branch matches expectations, but do NOT change it.
@@ -81,7 +81,7 @@ PHASE="$1"
 # would fall back to the `write` tool with a relative path, polluting
 # the project root).
 PROJECT_ROOT="$(pwd)"
-SOLY_DIR="$PROJECT_ROOT/.soly"
+SOLY_DIR="$PROJECT_ROOT/.agents"
 PHASE_DIR=$(ls -d "$SOLY_DIR/phases/"*"-$PHASE-"* 2>/dev/null | head -1) || { echo "Phase $PHASE not found" >&2; exit 1; }
 PADDED_PHASE=$(printf "%02d" "$(echo "$PHASE" | grep -oE '^[0-9]+' | sed 's/^0*//')")
 PHASE_SLUG=$(basename "$PHASE_DIR")
@@ -103,8 +103,8 @@ HAS_SUMMARIES=$(ls "$PHASE_DIR"/${PADDED_PHASE}-*-SUMMARY.md 2>/dev/null | wc -l
 **3. Read phase context** (also in the iteration file) in priority order:
 1. `<phase>-CONTEXT.md` if exists — user decisions, honor them. Missing decision in an area you need to plan → surface in report.
 2. `<phase>-RESEARCH.md` if exists — chosen libs/patterns. Pitfalls → Must Haves or task body.
-3. `.soly/ROADMAP.md` — this phase's row: goal, requirements, deps on other phases.
-4. `.soly/REQUIREMENTS.md` if exists — full text + acceptance criteria for each `phase_req_ids`. Every requirement → some plan's `requirements:` array.
+3. `.agents/ROADMAP.md` — this phase's row: goal, requirements, deps on other phases.
+4. `.agents/REQUIREMENTS.md` if exists — full text + acceptance criteria for each `phase_req_ids`. Every requirement → some plan's `requirements:` array.
 5. Up to 3 most recent prior `*-SUMMARY.md` — what was already built.
 
 **4. Decompose into plans.**
@@ -156,7 +156,7 @@ git commit -m "chore(${PADDED_PHASE}): plan phase <N> — <M> plan(s)"
 - Phase status → `Planned`, `current_plan` → 1.
 - `last_updated` → `date -u +"%Y-%m-%dT%H:%M:%SZ"`.
 - If STATE.md has `progress:`, increment `total_plans` by new plan count.
-- Keep < 150 lines — archive to `.soly/DECISIONS-INDEX.md` if it grows.
+- Keep < 150 lines — archive to `.agents/DECISIONS-INDEX.md` if it grows.
 
 **9. Report:**
 
@@ -188,7 +188,7 @@ Parent summarizes + asks confirmation. On confirm: `soly execute-plan <N>` (or `
 
 <hard_rules>
 - No production code. Planning only.
-- No subagents (you ARE one). No `.soly/rules/` edits. No `.soly/docs/` edits without surfacing to parent.
+- No subagents (you ARE one). No `.agents/rules/` edits. No `.agents/docs/` edits without surfacing to parent.
 - No git branch create/rename/switch.
 - `must_haves` (truths/artifacts/key_links) is NOT optional — executor relies on it for self-verification.
 - Every acceptance criterion is RUNNABLE — command/check/test, not "works correctly" or "feels right".

package/workflows-data/plan-task.md

@@ -1,10 +1,10 @@
 # Plan Task Workflow
 
-# Всегда соблюдай правила проекта из .soly/rules/
+# Всегда соблюдай правила проекта из .agents/rules/
 # Не используй shortcuts ради скорости
 
 <path_discipline>
-**All soly-managed files live under `.soly/`.** PLAN.md lives at `.soly/features/<feature>/tasks/<task-id>/PLAN.md`. Never write plan files to the project root. Use absolute paths.
+**All soly-managed files live under `.agents/`.** PLAN.md lives at `.agents/features/<feature>/tasks/<task-id>/PLAN.md`. Never write plan files to the project root. Use absolute paths.
 
 The iteration context file (path given by the parent in the task prompt) is your single source of truth for intent, STATE, the feature README, prior task SUMMARYs, and the current task PLAN (for refinement). Read it FIRST.
 </path_discipline>
@@ -18,14 +18,14 @@ executor can pick it up standalone.
 
 <required_reading>
 Before any planning, read:
-1. .soly/docs/ — INTENT (0-point)
-2. .soly/STATE.md — current state
-3. .soly/ROADMAP.md — high-level requirements
-4. .soly/features/<feature>/README.md — feature context
-5. .soly/contracts/* — shared API schemas (if any)
+1. .agents/docs/ — INTENT (0-point)
+2. .agents/STATE.md — current state
+3. .agents/ROADMAP.md — high-level requirements
+4. .agents/features/<feature>/README.md — feature context
+5. .agents/contracts/* — shared API schemas (if any)
 6. The task's existing PLAN.md (if refining) or relevant sibling tasks (if creating)
 
-If `.soly/features/` is empty for the target feature, error and stop.
+If `.agents/features/` is empty for the target feature, error and stop.
 Do not invent feature paths.
 </required_reading>
 
@@ -36,7 +36,7 @@ PLAN.md starts with a YAML frontmatter block. The executor depends on it.
 ---
 id: auth-be-login-a3f9   # slug-4hex, must match the directory name
 kind: be                  # be | fe | infra | docs | integration
-feature: auth             # parent feature name (must match .soly/features/<feature>/)
+feature: auth             # parent feature name (must match .agents/features/<feature>/)
 status: ready             # ready | in-progress | blocked | done
 priority: high            # high | medium | low
 parallelizable: true      # whether this task can run alongside other parallel tasks
@@ -68,7 +68,7 @@ If unclear, error and ask the parent.
 </step>
 
 <step name="read_intent" priority="first">
-**0-POINT CHECK.** Re-read `.soly/docs/` (intent docs) before any planning.
+**0-POINT CHECK.** Re-read `.agents/docs/` (intent docs) before any planning.
 The task PLAN.md is the contract; intent docs are the WHY. If you find
 a conflict, flag it instead of silently choosing.
 
@@ -79,13 +79,13 @@ read it directly from its path.
 </step>
 
 <step name="read_feature">
-Read `.soly/features/<feature>/README.md` for feature-level context.
+Read `.agents/features/<feature>/README.md` for feature-level context.
 If missing, note it but proceed (the parent may not have written one yet).
 </step>
 
 <step name="check_contracts">
 If the task touches API surfaces (BE endpoints, FE request shapes, shared
-types), read `.soly/contracts/<feature>.openapi.yaml` or similar. Contracts
+types), read `.agents/contracts/<feature>.openapi.yaml` or similar. Contracts
 are the synchronizing artifact between parallel BE and FE tasks.
 </step>
 
@@ -137,13 +137,13 @@ For new-task, commit the new PLAN.md:
 ```
 # Use absolute path with `cd "$PROJECT_ROOT"` so git doesn't interpret
 # a bare relative path as cwd-relative.
-cd "$PROJECT_ROOT" && git add .soly/features/<feature>/tasks/<id>/PLAN.md
+cd "$PROJECT_ROOT" && git add .agents/features/<feature>/tasks/<id>/PLAN.md
 git commit -m "chore(tasks): plan <id>"
 ```
 
 For existing-task refinement, commit only if material change:
 ```
-cd "$PROJECT_ROOT" && git add .soly/features/<feature>/tasks/<id>/PLAN.md
+cd "$PROJECT_ROOT" && git add .agents/features/<feature>/tasks/<id>/PLAN.md
 git commit -m "chore(tasks): refine plan <id>"
 ```
 
@@ -152,7 +152,7 @@ If nothing material changed, do not commit.
 **Worker bash setup (when you do need it):**
 ```bash
 PROJECT_ROOT="$(pwd)"  # worker inherits parent cwd = project root
-SOLY_DIR="$PROJECT_ROOT/.soly"
+SOLY_DIR="$PROJECT_ROOT/.agents"
 ```
 </step>
 
@@ -172,14 +172,14 @@ Return to parent:
 - Preserve existing frontmatter on refinement. Only update if you find a bug.
 - For new-task, generate the id as `<slug>-<4hex>` (lowercase).
 - Commit messages follow Conventional Commits 1.0.0 — `chore(tasks): ...`.
-- Do not modify `.soly/rules/`.
+- Do not modify `.agents/rules/`.
 - Do not run subagents yourself.
-- **PATH DISCIPLINE:** PLAN.md goes to `.soly/features/<feature>/tasks/<id>/PLAN.md`. Never to the project root.
+- **PATH DISCIPLINE:** PLAN.md goes to `.agents/features/<feature>/tasks/<id>/PLAN.md`. Never to the project root.
 - Return: created/refined path, task id, plan summary, open questions.
 </hard_rules>
 
 <dual_mode_note>
 Tasks are part of soly's dual-mode system. The project may also have
-`.soly/phases/` (phase-based layout, distinct from task-based). You are only planning a specific task.
+`.agents/phases/` (phase-based layout, distinct from task-based). You are only planning a specific task.
 Do not touch phases. Do not modify ROADMAP.md or STATE.md.
 </dual_mode_note>