@zalom/plastic 1.9.0 → 1.10.0

package/skills/store-indexing/references/zettelkasten-linking.md

@@ -14,7 +14,7 @@
    `intent:` text. Ordering is mandatory: all `sources` first (top), then all `chain`,
    frontmatter order preserved within each group. Sources never appear at the end. No
    source/chain tags, no sub-grouping.
-2. **Sources/Chain** (knowledge graph): `sources` = direct ascendants this was created from (formation, acyclic, must-load); `chain` = forward continuations and related successors (may cycle, lighter context). See `docs/concepts/how-plastic-sources-and-chains-intents.md` for the full model.
+2. **Sources/Chain** (knowledge graph): `sources` = direct ascendants this was created from (formation, acyclic, must-load); `chain` = forward continuations and related successors (may cycle, lighter context). See [`how-plastic-sources-and-chains-intents.md`](https://github.com/zalom/plastic/blob/main/docs/concepts/how-plastic-sources-and-chains-intents.md) for the full model.
 3. **Tags** (weakest) — shared tags, `project-<name>` for project membership
 
 ## When to Create a Cluster

package/skills/tutorial/references/track-1-guided.md

@@ -120,6 +120,6 @@ two, exactly the README section (or note) just delivered.
 ## Wrap and where to go next
 
 That is the full cycle once: create, board, decide, spec, plan, build, done. Read
-`docs/guides/your-first-intent-in-10-minutes.md` for the same path condensed to a single
-read, and `docs/guides/what-the-gates-are-telling-you.md` for what to do if a station denies
+[`your-first-intent-in-10-minutes.md`](https://github.com/zalom/plastic/blob/main/docs/guides/your-first-intent-in-10-minutes.md) for the same path condensed to a single
+read, and [`what-the-gates-are-telling-you.md`](https://github.com/zalom/plastic/blob/main/docs/guides/what-the-gates-are-telling-you.md) for what to do if a station denies
 an action instead of completing it.

package/skills/tutorial/references/track-2-auto.md

@@ -55,9 +55,11 @@ Checkpoint: name one thing auto will always stop and ask about, rather than deci
 
 No new command. Auto still honors every hard gate a guided session would hit: the delivery
 lock (one owner at a time), the code gate (shut until `plan.md` and `checklist.md` exist),
-and the create gate (intents only come from the tool that makes them, never hand-authored).
+the create gate (intents only come from the tool that makes them, never hand-authored), the
+links gate (a `## Links` section changes only to match the file's own frontmatter), and the
+bash gate (a shell command cannot write project code the code gate would have blocked).
 
-Checkpoint: read one gate message from the run so far and name which of the three gates it
+Checkpoint: read one gate message from the run so far and name which of the five gates it
 came from.
 
 ### 4. Reading the per-stage reports
@@ -65,7 +67,8 @@ came from.
 No new command. At each stage boundary (What, Why, How, Exec, Done) the agent briefs in a
 fixed three-line shape: State (what happened and why it matters), Risk (the one thing that
 could bite, or "nothing flagged"), and Call (the decision left to the user, or the call the
-agent is taking on its own).
+agent is taking on its own). That is the depth for a medium or large intent. A small intent
+gets one briefing, at How, folding in what the earlier stages would have said.
 
 Checkpoint: in the most recent report, point at the State line, the Risk line, and the Call
 line.
@@ -84,10 +87,10 @@ at and how that matched what was actually on disk.
 ## Wrap and where to go next
 
 Auto keeps the same stages and the same gates as guided; the only difference is who steers.
-Read `docs/guides/pick-your-mode.md` for the honest trade-off between guided and auto, and
-`docs/guides/using-plastic-with-claude-code.md` for how that choice feels day to day and how
+Read [`pick-your-mode.md`](https://github.com/zalom/plastic/blob/main/docs/guides/pick-your-mode.md) for the honest trade-off between guided and auto, and
+[`using-plastic-with-claude-code.md`](https://github.com/zalom/plastic/blob/main/docs/guides/using-plastic-with-claude-code.md) for how that choice feels day to day and how
 it connects to roadmap-driven delivery. For denial messages met along the way, read
-`docs/guides/what-the-gates-are-telling-you.md`.
+[`what-the-gates-are-telling-you.md`](https://github.com/zalom/plastic/blob/main/docs/guides/what-the-gates-are-telling-you.md).
 
 Note on terms: "guided" means the user starts each stage with a command and the agent
 narrows the thinking inside it, the same shape track 1 walked. "Manual", editing project

package/skills/tutorial/references/track-3-projects-and-roadmaps.md

@@ -106,6 +106,6 @@ waiting on a release to exist first.
 
 This is the same What, Why, How, Exec cycle from tracks 1 and 2, repeated across a project
 and gathered by a roadmap. Read
-`docs/guides/using-plastic-with-claude-code.md` for roadmap-driven delivery in more depth,
+[`using-plastic-with-claude-code.md`](https://github.com/zalom/plastic/blob/main/docs/guides/using-plastic-with-claude-code.md) for roadmap-driven delivery in more depth,
 including a real worked roadmap. For the exact roadmap file format beyond what this
 walkthrough covers, the `plastic-roadmap` skill itself is the reference.

package/skills/uninstall/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plastic-uninstall
-description: Use when the user wants to remove Plastic from an agent. Runs the manifest-driven uninstaller (removes skills, hooks, statusline, and any legacy plugin layout), reports exactly what was removed and what was left behind, then gives verification steps. Optionally deletes the intent store.
+description: Use when the user wants to remove Plastic from an agent. Runs the manifest-driven uninstaller (removes skills, hooks, statusline, and any legacy plugin layout), reports exactly what was removed and what was left behind, then gives verification steps. The intent store always stays.
 user-invocable: true
 ---
 
@@ -51,7 +51,7 @@ ls ~/.claude/hooks  | grep '^plastic-'    # -> no output
 grep -n plastic ~/.claude/settings.json   # -> no plastic hook/plugin refs
 ```
 
-### Step 4: Report + offer the data decision
+### Step 4: Report
 
 Emit the reporting block, using the Step 3 checks for the verification line:
 
@@ -67,12 +67,9 @@ Then:
 ```
 Plastic is uninstalled from [agent].
 Your intent store at ~/.plastic/ is untouched.
-
-Delete it too?
-  a) Keep everything (recommended): re-install anytime with npx
-  b) Delete everything now: removes ~/.plastic/ entirely (irreversible)
 ```
 
-- **Keep:** "Your data is at ~/.plastic/. Re-install anytime with
-  `npx -y @zalom/plastic@latest install --claude` (or your channel)."
-- **Delete:** run `rm -rf ~/.plastic/` and confirm.
+Uninstall removes installed harness files only. The store at `~/.plastic/` (intents,
+history, projects, config, version ledger) always stays; no uninstall path deletes it.
+Tell the user: "Your data is at ~/.plastic/. Re-install anytime with
+`npx -y @zalom/plastic@latest install --claude` (or your channel)."

package/templates/agents.md

@@ -23,31 +23,30 @@ means preferring a detected tool's own search or navigation over a generic file
 4. **Use [[global:ID]]** to link back to the governing strategic intent
 5. **Auto-commit** all intent changes in this project's git repo
 
-## Intent Lifecycle — What→Why→How→Next
+## Intent Lifecycle — What→Why→How→Exec
 
 State is derived from filesystem conventions, not frontmatter fields:
 
 | Convention | Signal |
 |---|---|
-| `## Context` has content | Intent is permanent (not fleeting) |
-| `actions/` directory exists | Intent is actionable |
+| `## Context` has content | Intent is permanent (developed, actionable) |
 | `## Outcome` has content | Intent is done |
 
 Sections map to the lifecycle:
 - **## Intent** — What (the desire)
 - **## Context** — Why (background + ### Decisions)
-- **## Outcome** — How (the result, deliverables)
-- **## Insights** — Next (observations, raw material for future intents)
+- **## Outcome** — Exec (the result; How's deliverables are the `plan.md`, `actions/`, and `checklist.md` files)
+- **## Insights** — observations across all stages, raw material for future intents
 
 Active/Future/Completed placement is managed in INDEX.md, not in frontmatter.
 
 ## Creating Tactical Intents
 
-1. Scan `.plastic/store/` for the next sequential ID
-2. Generate ID: `~/.plastic/scripts/folgezettel-id`
-3. Create `.plastic/store/ID--slug/ID--slug.md`
-4. Set frontmatter: `id`, `intent`, `sources` (array — link to governing intent), `chain` (starts empty), `created`, `author`, `tags`
-5. Add `[[global:ID]]` backlink in `## Links`
+Create through the `plastic-intent-creating` skill, which scaffolds with one call:
+`ruby ~/.plastic/scripts/new-intent --store .plastic/store --intent "<one-line>" --slug <slug> [--sources <governing-id>]`.
+It allocates the Folgezettel ID, creates `.plastic/store/ID--slug/ID--slug.md` born
+complete, and wires the links. Never hand-author the files: the write-time create gate
+rejects an incomplete or malformed intent file.
 
 ## Lifecycle Skills
 
@@ -56,12 +55,13 @@ Plastic has its own lifecycle skills. When a Plastic skill exists for the curren
 | Phase | Skill | Produces |
 |-------|-------|----------|
 | What | `plastic-intent-creating` | Intent file |
-| Why | `plastic-intent-brainstorming` | `spec.md` |
+| Why | `plastic-intent-brainstorming` | Enriched `## Context` + `### Decisions` |
+| Why | `plastic-intent-speccing` | `spec.md` |
 | Why | `plastic-intent-researching` | `resources/*.md` |
 | Why | `plastic-intent-grilling` | Deep interrogation |
 | How | `plastic-intent-planning` | `plan.md`, `checklist.md`, `actions/` |
 | Exec | `plastic-intent-executing` | Code + `outcome.md` |
-| Done | `plastic-store-curating` | Lifecycle transition |
+| Done | `plastic-intent-ending` | Lifecycle transition |
 
 **Artifact convention:** ALL lifecycle artifacts go to the active intent directory (`store/{id}--{slug}/`). Never write specs to `docs/superpowers/specs/` or plans to `docs/superpowers/plans/`.
 

package/templates/config.yml

@@ -8,7 +8,8 @@ hash_algorithm: sha256-base36
 max_slug_words: 5
 agent:
   type: claude-code
-  parallel_mode: linear
+  # read-config falls back to linear when this key is absent
+  parallel_mode: agent-teams
 architect:
   style:
 
@@ -27,14 +28,14 @@ architect:
 #       plastic-executor: sonnet
 #       plastic-enforcer: opus
 #     codex:
-#       plastic-executor: gpt-5.1-codex
+#       plastic-executor: gpt-5.6-terra
 
 # The advisor (intent 185): two consultation agents, plastic-advisor (the real
 # advisor, expensive, model fable by default) and plastic-faux-advisor (the
 # cheaper imitation, model opus by default, carrying the same reasoning
 # discipline inline). advisor.enabled defaults to enabled; missing or
-# unreadable counts as enabled (fail-open). The claude.default/primary/
-# secondary values are AGENT NAMES, never model names, so a slot can point at
+# unreadable counts as enabled (fail-open). The claude.default value is an
+# AGENT NAME, never a model name, so it can point at
 # a locally registered agent instead. Set at install time via --no-advisor /
 # --advisor, or uncomment here directly. Each agent's actual model is a plain
 # agents.models.claude.<name> override, same mechanism as any other agent.
@@ -42,6 +43,4 @@ architect:
 #   enabled: false               # skip installing both advisor agents and the
 #                                 # agent-advisor skill entirely
 #   claude:
-#     default: plastic-faux-advisor    # which agent the advisor skill routes to
-#     primary: plastic-advisor         # the real advisor slot
-#     secondary: plastic-faux-advisor  # the cheaper advisor slot
+#     default: plastic-advisor         # which agent the advisor skill routes to

package/templates/index.md

@@ -1,9 +1,9 @@
 # Index
 
 ## Active
-<!-- Line shape: `- [ID — Title](path)`. The em-dash (U+2014, not a plain hyphen)
-     between id and title is load-bearing: Bridge.intent_active? matches only that
-     shape, and a plain hyphen there fails the lock gate open (see docs/internals.md). -->
+<!-- Line shape: `- [ID — Title](path)`. Writes emit the em-dash (U+2014) between
+     id and title; readers (Bridge.index_entry_match) accept the em-dash or a plain
+     hyphen, so either form parses (see https://github.com/zalom/plastic/blob/main/docs/internals.md). -->
 (no active intents)
 
 ## Future
@@ -12,5 +12,8 @@
 ## Clusters
 (clusters emerge as intents accumulate; add headings when 3+ intents share a topic)
 
+## Abandoned
+(links preserved, never deleted)
+
 ## Completed
 (links preserved, never deleted)

package/templates/spec.md

@@ -13,7 +13,7 @@
 (the chosen approach, in prose)
 
 ## Alternatives Considered
-- <alternative> — not chosen because ...
+- <alternative>: not chosen because ...
 
 ## Decisions
 - ...