@zalom/plastic 1.0.0-alpha.33 → 1.0.0-alpha.34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/PLASTIC.md CHANGED
@@ -97,6 +97,26 @@ succession at a glance (last line = where we are).
97
97
  brainstorming, writing-plans, etc., Plastic's directory rules override
98
98
  their default output paths.
99
99
 
100
+ ## Defaults-First
101
+
102
+ Plastic stands on its own. Skills and agents use Plastic's own defaults; an
103
+ external skill (for example `superpowers:*`) is opt-in, never load-bearing.
104
+
105
+ - **Default to Plastic, delegate by exception.** Name the Plastic-native path as
106
+ the default. Delegate to an external skill only when (a) it is available in the
107
+ harness, or (b) the user explicitly asks for it. A user without that plugin must
108
+ still get the core behavior.
109
+ - **Phrase external skills as enhancements.** Write "use Plastic's native X by
110
+ default; if `superpowers:<skill>` is available, or the user prefers it, delegate
111
+ to it" never "delegate to `superpowers:<skill>`" as the only path.
112
+ - **Optional dependencies detect then degrade.** `qmd` is the reference shape:
113
+ `scripts/lib/qmd_sync.rb` detects the binary first and every verb no-ops cleanly
114
+ when it is absent (see `scripts/qmd-sync`). Optional CLIs and MCP servers follow
115
+ the same detect-then-skip pattern, so a missing tool never crashes a session.
116
+ - **Legitimate hard dependencies are exempt.** Ruby, Node, git, and POSIX tools are
117
+ the cost of running Plastic, not silent coupling. The principle targets accidental
118
+ dependence on external skills doing work Plastic should do itself.
119
+
100
120
  ## State System
101
121
 
102
122
  ```
@@ -25,12 +25,12 @@ You are the Plastic Enforcer. You ARE the auto orchestrator, spanning the whole
25
25
  1. Arm the gate, then dispatch the brainstorming specialist; gate its `## Context` + `### Decisions`
26
26
  2. Dispatch the spec-specialist; gate `spec.md`. Then the planner; gate `plan.md` + `checklist.md`
27
27
  3. Dispatch the executor; require a green suite. Sequential, one team per intent, on one branch when files are shared
28
- 4. Delegate real parallelism and dispatch to `superpowers:subagent-driven-development` and `superpowers:dispatching-parallel-agents`
28
+ 4. Dispatch and review by default through Plastic's native engine, `plastic-executing-plan` (implementer plus two-stage review, no external plugin). If `superpowers:subagent-driven-development` and `superpowers:dispatching-parallel-agents` are available, or the user asks for them, delegate to them as an enhancement
29
29
  5. At the final gate, dispatch an independent reviewer subagent, then complete the intent
30
30
 
31
31
  ## Constraints
32
32
 
33
33
  - Enforce gates manually; do not rely on hooks, because `CLAUDE_SESSION_ID` may be unset in headless or background runs
34
34
  - You never delegate gate ownership; the orchestrator is always the gate-keeper
35
- - Roles are thin handoff contracts, not an execution engine; delegate dispatch to the superpowers skills
36
- - If the harness has no subagent dispatch, fall back to a single agent walking the full cycle
35
+ - Roles are thin handoff contracts, not an execution engine; dispatch through `plastic-executing-plan` by default, and through the superpowers skills only when they are available or the user prefers them
36
+ - Fall back by case: if the harness supports subagents but superpowers is absent, use the native `plastic-executing-plan` engine; if the harness has no subagent dispatch at all, fall back to a single agent walking the full cycle
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zalom/plastic",
3
- "version": "1.0.0-alpha.33",
3
+ "version": "1.0.0-alpha.34",
4
4
  "description": "Intent-driven idea development system for AI coding agents",
5
5
  "type": "module",
6
6
  "bin": {
@@ -64,7 +64,7 @@ Roster (one role per cycle stage):
64
64
  - **plastic-executor** (code + checklist + `## Insights`)
65
65
  - **plastic-enforcer** (orchestrates + gates; that is YOU)
66
66
 
67
- Dispatch rule: sequential, one specialist per stage on one branch (the deliverables share files). Gate each deliverable against the stage's exit criteria before handing off. Delegate the actual How and Exec dispatch to `superpowers:subagent-driven-development` and `superpowers:dispatching-parallel-agents` (see the How and Exec phases below); do not restate them.
67
+ Dispatch rule: sequential, one specialist per stage on one branch (the deliverables share files). Gate each deliverable against the stage's exit criteria before handing off. The How and Exec phases below default to Plastic's native dispatch (`plastic-executing-plan`) and delegate to the superpowers skills only when they are available or the user asks; do not restate the phase mechanics here.
68
68
 
69
69
  Final-gate review: dispatch an independent reviewer subagent at the final gate only, not as a standing role.
70
70
 
@@ -64,16 +64,21 @@ derived-key fallback and verifies state itself.
64
64
 
65
65
  ### Delegation
66
66
 
67
- The roles are thin handoff contracts, not a spawning engine. Real parallelism and
68
- dispatch are delegated to `superpowers:subagent-driven-development` and
69
- `superpowers:dispatching-parallel-agents`. The team model defines who hands what to
70
- whom and where the gates sit, the superpowers skills do the actual dispatching.
71
-
72
- ### Solo Fallback
73
-
74
- If the harness has no subagent dispatch, auto mode falls back to a single agent
75
- walking the full What, Why, How, Exec cycle itself. This preserves the original
76
- behavior on harnesses without teams. The enforcer's gate discipline still applies.
67
+ The roles are thin handoff contracts, not a spawning engine. Dispatch and review run
68
+ by default through Plastic's own engine, `plastic-executing-plan` (implementer plus
69
+ two-stage review, no external plugin). When `superpowers:subagent-driven-development`
70
+ and `superpowers:dispatching-parallel-agents` are available, or the user asks for them,
71
+ they delegate to those as an enhancement. The team model defines who hands what to whom
72
+ and where the gates sit; the dispatch engine, native or superpowers, does the actual
73
+ spawning.
74
+
75
+ ### Fallback by Case
76
+
77
+ The default is always Plastic's native engine, so a user without superpowers still gets
78
+ the full behavior. If the harness supports subagents but superpowers is absent, auto
79
+ mode dispatches through `plastic-executing-plan`. If the harness has no subagent dispatch
80
+ at all, auto mode falls back to a single agent walking the full What, Why, How, Exec
81
+ cycle itself. The enforcer's gate discipline still applies in every case.
77
82
 
78
83
  ### Dogfood Proof
79
84
 
@@ -3,7 +3,7 @@ name: plastic-brainstorming-grill-me
3
3
  description: >-
4
4
  Deep brainstorming that interviews the user relentlessly about a plan or design until reaching shared understanding.
5
5
  Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
6
- Complements superpowers:brainstorming — use brainstorming for quick ideation, grill-me for thorough interrogation.
6
+ Pair with plastic-brainstorming for quick ideation and use grill-me for thorough interrogation. If superpowers:brainstorming is installed it complements this skill, but it is not required.
7
7
  ---
8
8
 
9
9
  # Grill Me — Deep Brainstorming