Skip to content

Commit e5ecf8e

Browse files
README: Superpowers → Why Turnstone, vertical mermaid
- Replaced Relationship to Superpowers with Why Turnstone section highlighting Turnstone's governance surface as the engine's native enforcement layer. - Mermaid diagrams: changed from LR (horizontal) to TB (vertical) in both README and architecture.md for readability. - Superpowers retained in credits as prior art with a shorter, more precise acknowledgment.
1 parent 5adbacd commit e5ecf8e

2 files changed

Lines changed: 13 additions & 6 deletions

File tree

‎README.md‎

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Process Engine is a persona-and-skills generator for Turnstone: tell it what you
1111
Tell it what you want to build, share any material you already have, and it produces a complete Turnstone-native package — project, persona, skills, templates — through a gated pipeline:
1212

1313
```mermaid
14-
flowchart LR
14+
flowchart TB
1515
A[Intent] --> B[Orient]
1616
B --> C[Collect]
1717
C --> D[Clarify]
@@ -43,11 +43,18 @@ Every gate requires operator sign-off. Turnstone's native prompt policy and advi
4343

4444
Process Engine is domain-neutral in package structure, artifact-specific, and runtime-aware. It's been exercised on Etsy store management, supplement product listings, incident response, employee onboarding, database backup operations, and financial planning advisories — not just software engineering.
4545

46-
## Relationship to Superpowers
46+
## Why Turnstone
4747

48-
[Superpowers](https://github.com/obra/superpowers) gives coding agents a mature, ready-to-use software-development methodology — plan, test, review, complete. Process Engine operates one level higher: it is **a system for designing, testing, and maintaining custom agent operating packages**, of which a software-development methodology is one possible output.
48+
Process Engine runs on Turnstone because Turnstone's governance surface is what the engine produces. Every generated package includes governance objects — prompt policy and advisory judge rules — that Turnstone enforces mechanically. The engine's "operator is the gate" philosophy maps directly to Turnstone's native approval surfaces.
4949

50-
Superpowers is a finished methodology; Process Engine is a methodology factory. The two are complementary: Superpowers disciplines the code; Process Engine disciplines the package that disciplines the code.
50+
| Harness | Governance layer |
51+
|---|---|
52+
| **Turnstone** | Full — projects, personas, roles, policies, prompts, judge, audit |
53+
| Hermes | Agent runtime — no governance objects |
54+
| OpenClaw | Agent + channels — emission-focused |
55+
| Claude | Commercial harness — no governance layer |
56+
57+
You don't need Turnstone to use Process Engine, but you need Turnstone for the governance wiring. The engine's prompt policy and advisory judge rules are Turnstone-native artifacts that enforce the gates mechanically — the model generates packages; Turnstone owns the guardrails.
5158

5259
## The engine's components
5360

@@ -127,5 +134,5 @@ MIT — see [LICENSE](LICENSE).
127134

128135
- **Generation basis:** [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) (MIT) — engineering discipline catalog
129136
- **Format standard:** [agentskills/agentskills](https://github.com/agentskills/agentskills) (Apache-2.0 / CC-BY-4.0) — Agent Skills open format
130-
- **Prior art & inspiration:** [Superpowers](https://github.com/obra/superpowers) — a mature software-development methodology for coding agents
137+
- **Prior art & inspiration:** [Superpowers](https://github.com/obra/superpowers) — a mature software-development methodology that applies a related evidence-first philosophy to coding agents. Process Engine operates one level higher: creating and qualifying the agent packages that contain methodologies like that.
131138
- **Platform:** native [turnstone](https://github.com/turnstonelabs/turnstone) mechanisms (projects, personas, skills, prompt templates, judge)

‎docs/architecture.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Process Engine (project)
3434
## The pipeline
3535

3636
```mermaid
37-
flowchart LR
37+
flowchart TB
3838
A[Intent] --> B[Orient]
3939
B --> C[Collect]
4040
C --> D[Clarify]

0 commit comments

Comments
 (0)