@esoteric-logic/praxis-harness 2.7.0 → 2.8.0

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.
Files changed (50) hide show
  1. package/README.md +48 -48
  2. package/base/CLAUDE.md +23 -23
  3. package/base/skills/{architecture-patterns → px-architecture-patterns}/SKILL.md +1 -1
  4. package/base/skills/{code-gc → px-code-gc}/SKILL.md +1 -1
  5. package/base/skills/{communication-standards → px-communication-standards}/SKILL.md +1 -1
  6. package/base/skills/{context-probe → px-context-probe}/SKILL.md +1 -1
  7. package/base/skills/{context-reset → px-context-reset}/SKILL.md +1 -1
  8. package/base/skills/{context7-lookup → px-context7-lookup}/SKILL.md +1 -1
  9. package/base/skills/{debug → px-debug}/SKILL.md +1 -1
  10. package/base/skills/{deliberate → px-deliberate}/SKILL.md +1 -1
  11. package/base/skills/{discover → px-discover}/SKILL.md +1 -1
  12. package/base/skills/{discuss → px-discuss}/SKILL.md +1 -1
  13. package/base/skills/{execute → px-execute}/SKILL.md +1 -1
  14. package/base/skills/{fast → px-fast}/SKILL.md +1 -1
  15. package/base/skills/{kit → px-kit}/SKILL.md +1 -1
  16. package/base/skills/{managing-git-identities → px-managing-git-identities}/SKILL.md +1 -1
  17. package/base/skills/{next → px-next}/SKILL.md +1 -1
  18. package/base/skills/{plan → px-plan}/SKILL.md +1 -1
  19. package/base/skills/{plan-writer → px-plan-writer}/SKILL.md +1 -1
  20. package/base/skills/{pre-commit-lint → px-pre-commit-lint}/SKILL.md +1 -1
  21. package/base/skills/{quick → px-quick}/SKILL.md +1 -1
  22. package/base/skills/{repair → px-repair}/SKILL.md +1 -1
  23. package/base/skills/{research → px-research}/SKILL.md +1 -1
  24. package/base/skills/{review → px-review}/SKILL.md +1 -1
  25. package/base/skills/{risk → px-risk}/SKILL.md +1 -1
  26. package/base/skills/{scaffold-exist → px-scaffold-exist}/SKILL.md +1 -1
  27. package/base/skills/{scaffold-new → px-scaffold-new}/SKILL.md +1 -1
  28. package/base/skills/{secret-scan → px-secret-scan}/SKILL.md +1 -1
  29. package/base/skills/{session-retro → px-session-retro}/SKILL.md +1 -1
  30. package/base/skills/{ship → px-ship}/SKILL.md +1 -1
  31. package/base/skills/{simplify → px-simplify}/SKILL.md +1 -1
  32. package/base/skills/{spec → px-spec}/SKILL.md +1 -1
  33. package/base/skills/{standup → px-standup}/SKILL.md +1 -1
  34. package/base/skills/{status-update → px-status-update}/SKILL.md +1 -1
  35. package/base/skills/{subagent → px-subagent}/SKILL.md +1 -1
  36. package/base/skills/{sync-memory → px-sync-memory}/SKILL.md +1 -1
  37. package/base/skills/{vault-gc → px-vault-gc}/SKILL.md +1 -1
  38. package/base/skills/{verify → px-verify}/SKILL.md +1 -1
  39. package/base/skills/{verify-app → px-verify-app}/SKILL.md +1 -1
  40. package/package.json +1 -1
  41. package/scripts/test-harness.sh +6 -6
  42. /package/base/skills/{blind-judge → px-blind-judge}/SKILL.md +0 -0
  43. /package/base/skills/{dep-hygiene → px-dep-hygiene}/SKILL.md +0 -0
  44. /package/base/skills/{scaffold-new → px-scaffold-new}/references/claude-progress-template.json +0 -0
  45. /package/base/skills/{scaffold-new → px-scaffold-new}/references/gitignore-template.txt +0 -0
  46. /package/base/skills/{scaffold-new → px-scaffold-new}/references/repo-CLAUDE-md-template.md +0 -0
  47. /package/base/skills/{scaffold-new → px-scaffold-new}/references/vault-index-template.md +0 -0
  48. /package/base/skills/{scaffold-new → px-scaffold-new}/references/vault-learnings-template.md +0 -0
  49. /package/base/skills/{scaffold-new → px-scaffold-new}/references/vault-status-template.md +0 -0
  50. /package/base/skills/{scaffold-new → px-scaffold-new}/references/vault-tasks-template.md +0 -0
package/README.md CHANGED
@@ -10,7 +10,7 @@ Praxis gives Claude Code a three-layer operating system:
10
10
 
11
11
  **Universal base** — always loaded. Praxis structures work (discuss → plan → execute → verify → simplify → ship). Built-in quality enforcement (debugging, code review, simplification).
12
12
 
13
- **AI-Kits** — activated on demand via `/kit:<name>`. Each kit bundles domain-specific rules, skills, MCP servers, and slash commands. Activate the web-designer kit and your components get design system enforcement, accessibility auditing, and production lint. Deactivate with `/kit:off`.
13
+ **AI-Kits** — activated on demand via `/px-kit:<name>`. Each kit bundles domain-specific rules, skills, MCP servers, and slash commands. Activate the web-designer kit and your components get design system enforcement, accessibility auditing, and production lint. Deactivate with `/px-kit:off`.
14
14
 
15
15
  **Project config** — per-repo rules that fire automatically based on file paths. Terraform rules load when you touch `.tf` files. GitHub Actions rules load when you touch workflow YAML. No manual switching.
16
16
 
@@ -33,51 +33,51 @@ npx @esoteric-logic/praxis-harness@latest uninstall # remove Praxis-owned file
33
33
 
34
34
  ## After install
35
35
 
36
- Verify with `/help` — you should see Praxis commands (`/discuss`, `/execute`, `/verify`, `/plan`, `/ship`, `/kit:*`).
36
+ Verify with `/help` — you should see Praxis commands (`/px-discuss`, `/px-execute`, `/px-verify`, `/px-plan`, `/px-ship`, `/px-kit:*`).
37
37
 
38
38
  ## Workflow
39
39
 
40
40
  The standard Praxis workflow for feature development:
41
41
 
42
42
  ```
43
- /standup → orient (reads status.md, surfaces stale state)
44
- /discuss → frame the problem (conversational, scope guard)
45
- /discover → research options with confidence levels (before /spec)
46
- /plan → plan milestones (with dependency ordering + boundaries)
47
- /execute → implement one milestone at a time (file-group isolation)
48
- /verify → validate (test/lint/typecheck/build, self-review, UNIFY)
49
- /session-retro → capture learnings, update vault
43
+ /px-standup → orient (reads status.md, surfaces stale state)
44
+ /px-discuss → frame the problem (conversational, scope guard)
45
+ /px-discover → research options with confidence levels (before /px-spec)
46
+ /px-plan → plan milestones (with dependency ordering + boundaries)
47
+ /px-execute → implement one milestone at a time (file-group isolation)
48
+ /px-verify → validate (test/lint/typecheck/build, self-review, UNIFY)
49
+ /px-session-retro → capture learnings, update vault
50
50
  ```
51
51
 
52
- For pure bugfixes: `/debug` (test-first debugging, skips the full loop).
53
- For code review: `/review` (launches subagent review at any time).
54
- For technical research: `/discover` (structured options evaluation before decisions).
52
+ For pure bugfixes: `/px-debug` (test-first debugging, skips the full loop).
53
+ For code review: `/px-review` (launches subagent review at any time).
54
+ For technical research: `/px-discover` (structured options evaluation before decisions).
55
55
 
56
56
  ## Commands
57
57
 
58
58
  | Command | Purpose |
59
59
  |---------|---------|
60
- | `discuss` | Conversational problem framing, SPEC synthesis, scope guard |
61
- | `execute` | Implement one milestone with file-group isolation + boundary enforcement |
62
- | `verify` | Validate milestone (test/lint/build), self-review, UNIFY phase summary |
63
-
64
- | `plan` | Create a dated work plan with milestone dependencies + checkpoints |
65
- | `spec` | Create a structured spec or ADR with conflict detection |
66
- | `discover` | Structured technical discovery with confidence-rated options |
67
- | `standup` | Session-start orientation from vault state |
68
- | `risk` | Add a risk register entry to the vault |
69
- | `kit` | Activate/deactivate an AI-Kit |
70
- | `review` | Manual code review via subagent |
71
- | `simplify` | Post-implementation code simplification via subagent |
72
- | `debug` | Structured test-first debugging |
73
- | `ship` | Commit, push, and PR in one command with pre-flight checks |
74
- | `verify-app` | End-to-end verification with regression analysis |
75
- | `session-retro` | End-of-session retrospective with learnings extraction |
76
- | `status-update` | Manual vault status.md update |
77
- | `repair` | Structured 3-attempt fix-and-verify loop for failed milestones |
78
- | `sync-memory` | Bridge auto-memory insights to Obsidian vault |
79
- | `context-probe` | Assess context health and recommend action |
80
- | `context-reset` | Reload context from vault without clearing session |
60
+ | `px-discuss` | Conversational problem framing, SPEC synthesis, scope guard |
61
+ | `px-execute` | Implement one milestone with file-group isolation + boundary enforcement |
62
+ | `px-verify` | Validate milestone (test/lint/build), self-review, UNIFY phase summary |
63
+
64
+ | `px-plan` | Create a dated work plan with milestone dependencies + checkpoints |
65
+ | `px-spec` | Create a structured spec or ADR with conflict detection |
66
+ | `px-discover` | Structured technical discovery with confidence-rated options |
67
+ | `px-standup` | Session-start orientation from vault state |
68
+ | `px-risk` | Add a risk register entry to the vault |
69
+ | `px-kit` | Activate/deactivate an AI-Kit |
70
+ | `px-review` | Manual code review via subagent |
71
+ | `px-simplify` | Post-implementation code simplification via subagent |
72
+ | `px-debug` | Structured test-first debugging |
73
+ | `px-ship` | Commit, push, and PR in one command with pre-flight checks |
74
+ | `px-verify-app` | End-to-end verification with regression analysis |
75
+ | `px-session-retro` | End-of-session retrospective with learnings extraction |
76
+ | `px-status-update` | Manual vault status.md update |
77
+ | `px-repair` | Structured 3-attempt fix-and-verify loop for failed milestones |
78
+ | `px-sync-memory` | Bridge auto-memory insights to Obsidian vault |
79
+ | `px-context-probe` | Assess context health and recommend action |
80
+ | `px-context-reset` | Reload context from vault without clearing session |
81
81
 
82
82
  ## Rules
83
83
 
@@ -114,11 +114,11 @@ Key additions in this version:
114
114
 
115
115
  | Kit | Activate | What it does |
116
116
  |-----|----------|-------------|
117
- | web-designer | `/kit:web-designer` | Design system init → component build → accessibility audit → production lint |
118
- | infrastructure | `/kit:infrastructure` | Terraform plan → apply → drift detection → compliance check |
119
- | api | `/kit:api` | RESTful conventions → OpenAPI specs → contract testing |
120
- | security | `/kit:security` | Threat modeling → IAM review → OWASP audit |
121
- | data | `/kit:data` | Schema design → migration planning → query optimization |
117
+ | web-designer | `/px-kit:web-designer` | Design system init → component build → accessibility audit → production lint |
118
+ | infrastructure | `/px-kit:infrastructure` | Terraform plan → apply → drift detection → compliance check |
119
+ | api | `/px-kit:api` | RESTful conventions → OpenAPI specs → contract testing |
120
+ | security | `/px-kit:security` | Threat modeling → IAM review → OWASP audit |
121
+ | data | `/px-kit:data` | Schema design → migration planning → query optimization |
122
122
 
123
123
  More kits coming. See `docs/creating-a-kit.md` to build your own.
124
124
 
@@ -158,13 +158,13 @@ Praxis auto-documents your work in the vault with zero manual effort. Two indepe
158
158
 
159
159
  | Skill | Auto-writes to vault |
160
160
  |-------|---------------------|
161
- | `/execute` | `status.md` loop position, `decision-log.md` scope events |
162
- | `/verify` | `claude-progress.json` milestones[] |
163
- | `/review` | `specs/review-{date}-{slug}.md` (full findings breakdown) |
164
- | `/simplify` | `notes/{date}_simplify-findings.md` |
165
- | `/debug` | `notes/{date}_debug-trace.md` |
166
- | `/verify-app` | `specs/verify-app-{date}-{slug}.md` |
167
- | `/ship` | `claude-progress.json` features[] |
161
+ | `/px-execute` | `status.md` loop position, `decision-log.md` scope events |
162
+ | `/px-verify` | `claude-progress.json` milestones[] |
163
+ | `/px-review` | `specs/review-{date}-{slug}.md` (full findings breakdown) |
164
+ | `/px-simplify` | `notes/{date}_simplify-findings.md` |
165
+ | `/px-debug` | `notes/{date}_debug-trace.md` |
166
+ | `/px-verify-app` | `specs/verify-app-{date}-{slug}.md` |
167
+ | `/px-ship` | `claude-progress.json` features[] |
168
168
 
169
169
  **On context compaction** (automatic fallback):
170
170
  - `plans/{date}-compact-checkpoint.md` — git state, active plan, loop position
@@ -184,14 +184,14 @@ Re-copies all hooks, skills, rules, and kits from the latest npm package version
184
184
 
185
185
  ### Updating existing projects
186
186
 
187
- After a harness update that adds new vault files (like `decision-log.md`), run `/scaffold-exist` in a Claude Code session to audit your vault and add any missing files. This is non-destructive — it never overwrites existing content.
187
+ After a harness update that adds new vault files (like `decision-log.md`), run `/px-scaffold-exist` in a Claude Code session to audit your vault and add any missing files. This is non-destructive — it never overwrites existing content.
188
188
 
189
189
  ```
190
190
  Step 1: npx @esoteric-logic/praxis-harness@latest update → deploys new hooks, skills, rules
191
- Step 2: /scaffold-exist → audits vault, adds missing files
191
+ Step 2: /px-scaffold-exist → audits vault, adds missing files
192
192
  ```
193
193
 
194
- New projects get everything automatically via `/scaffold-new`.
194
+ New projects get everything automatically via `/px-scaffold-new`.
195
195
 
196
196
  ## Uninstalling
197
197
 
package/base/CLAUDE.md CHANGED
@@ -14,20 +14,20 @@ You are a senior engineering partner. Think before you build. Verify before you
14
14
 
15
15
  ## Workflow Hierarchy
16
16
  - **Praxis** owns the outer loop: discuss → plan → execute → verify → simplify → ship.
17
- Always start feature work with `/discuss` or `/next`.
17
+ Always start feature work with `/px-discuss` or `/px-next`.
18
18
  - **Kits** inject domain context into this workflow — they don't replace it.
19
- - Pure bugfixes: skip the full loop, use `/debug` directly.
20
- - Trivial changes (typos, config): use `/fast` to skip planning.
21
- - After every implementation: run `/simplify` to clean up code before verify.
22
- - Use `/verify-app` for end-to-end checks, `/ship` when ready to commit+push+PR.
19
+ - Pure bugfixes: skip the full loop, use `/px-debug` directly.
20
+ - Trivial changes (typos, config): use `/px-fast` to skip planning.
21
+ - After every implementation: run `/px-simplify` to clean up code before verify.
22
+ - Use `/px-verify-app` for end-to-end checks, `/px-ship` when ready to commit+push+PR.
23
23
 
24
24
  ## Plan Mode Protocol
25
25
  For non-trivial tasks (3+ steps):
26
26
  1. Start in Plan Mode — iterate on the plan until it's solid
27
27
  2. Switch to auto-accept edits and let Claude one-shot the implementation
28
- 3. Run `/simplify` after implementation
29
- 4. Run `/verify-app` to confirm everything works
30
- 5. Run `/ship` to commit, push, and PR
28
+ 3. Run `/px-simplify` after implementation
29
+ 4. Run `/px-verify-app` to confirm everything works
30
+ 5. Run `/px-ship` to commit, push, and PR
31
31
 
32
32
  ## Error Learning
33
33
  When a mistake is corrected: update project CLAUDE.md `## Error Learning` section
@@ -85,7 +85,7 @@ Registered via `claude mcp add`. Persist globally across sessions.
85
85
 
86
86
  | Server | Purpose | Install | Degrades without |
87
87
  |--------|---------|---------|-----------------|
88
- | perplexity | AI web search | `bash scripts/onboard-mcp.sh perplexity` | No web research in `/discover` |
88
+ | perplexity | AI web search | `bash scripts/onboard-mcp.sh perplexity` | No web research in `/px-discover` |
89
89
  | filesystem | Direct vault file access | `claude mcp add filesystem` | Uses shell for vault reads |
90
90
  | sequential-thinking | Multi-step reasoning | `claude mcp add sequential-thinking` | Standard reasoning only |
91
91
 
@@ -101,8 +101,8 @@ Missing servers are non-blocking — features degrade gracefully.
101
101
  - GitHub Actions → `~/.claude/rules/github-actions.md`
102
102
  - PowerShell scripts → `~/.claude/rules/powershell.md`
103
103
  - Git operation → `~/.claude/rules/git-workflow.md`
104
- - Client-facing writing → auto-loaded by `communication-standards` skill
105
- - Architecture/specs → auto-loaded by `architecture-patterns` skill
104
+ - Client-facing writing → auto-loaded by `px-communication-standards` skill
105
+ - Architecture/specs → auto-loaded by `px-architecture-patterns` skill
106
106
  5. Quality re-anchor: read most recent `compact-checkpoint.md` → check the Quality State section.
107
107
  - If lint findings existed before compaction: re-run `golangci-lint run`, confirm status.
108
108
  - If tests were failing before compaction: re-run test command, confirm status.
@@ -120,15 +120,15 @@ Missing servers are non-blocking — features degrade gracefully.
120
120
  - Use vault search when Obsidian is not running (obsidian backend requires Obsidian open)
121
121
 
122
122
  ## AI-Kit Registry
123
- Kits activate via `/kit:<n>` slash command. Kits are idempotent — double-activate is a no-op.
123
+ Kits activate via `/px-kit:<n>` slash command. Kits are idempotent — double-activate is a no-op.
124
124
 
125
125
  | Kit | Activate | Domain |
126
126
  |-----|----------|--------|
127
- | web-designer | `/kit:web-designer` | Design system → components → accessibility → production lint |
128
- | infrastructure | `/kit:infrastructure` | Terraform → Azure → GitHub Actions → compliance |
129
- | api | `/kit:api` | RESTful conventions → OpenAPI specs → contract testing |
130
- | security | `/kit:security` | Threat modeling → IAM review → OWASP audit |
131
- | data | `/kit:data` | Schema design → migration planning → query optimization |
127
+ | web-designer | `/px-kit:web-designer` | Design system → components → accessibility → production lint |
128
+ | infrastructure | `/px-kit:infrastructure` | Terraform → Azure → GitHub Actions → compliance |
129
+ | api | `/px-kit:api` | RESTful conventions → OpenAPI specs → contract testing |
130
+ | security | `/px-kit:security` | Threat modeling → IAM review → OWASP audit |
131
+ | data | `/px-kit:data` | Schema design → migration planning → query optimization |
132
132
 
133
133
  Kit manifests live in `~/.claude/kits/<name>/KIT.md`.
134
134
 
@@ -159,17 +159,17 @@ Kit manifests live in `~/.claude/kits/<name>/KIT.md`.
159
159
  ### Auto-invocable skills (replace former universal rules)
160
160
  | Skill | Triggers when |
161
161
  |-------|--------------|
162
- | `communication-standards` | Writing client-facing docs, proposals, status reports, commits, PRs |
163
- | `architecture-patterns` | Writing ADRs, specs, system design, risk docs, blocker reports |
162
+ | `px-communication-standards` | Writing client-facing docs, proposals, status reports, commits, PRs |
163
+ | `px-architecture-patterns` | Writing ADRs, specs, system design, risk docs, blocker reports |
164
164
 
165
165
  ## Judgment & Research Commands
166
166
 
167
167
  | Command | Purpose |
168
168
  |---------|---------|
169
- | `/duel` | Parallel Alpha/Beta implementation → blind scoring → synthesis |
170
- | `/deliberate` | Multi-perspective decision analysis with scored option matrix |
171
- | `/freshness` | Full dependency audit — CVEs, outdated packages, maintenance status |
172
- | `/research <pkg>` | Live docs (Context7) + CVE/version/maintenance check (Perplexity Sonar) |
169
+ | `/px-duel` | Parallel Alpha/Beta implementation → blind scoring → synthesis |
170
+ | `/px-deliberate` | Multi-perspective decision analysis with scored option matrix |
171
+ | `/px-freshness` | Full dependency audit — CVEs, outdated packages, maintenance status |
172
+ | `/px-research <pkg>` | Live docs (Context7) + CVE/version/maintenance check (Perplexity Sonar) |
173
173
 
174
174
  MCP server templates: `base/configs/mcp-servers.json` — declarative config for context7, github, perplexity-sonar.
175
175
  Dependency registry: `base/configs/registry.json` — single source of truth for all tools, auth, hooks.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: architecture-patterns
2
+ name: px-architecture-patterns
3
3
  description: "Architecture decision and design documentation standards. Auto-triggers when writing ADRs, technical specs, risk register entries, system design documents, or any decision that affects system design, network topology, identity model, data residency, security posture, or compliance scope. Also triggers when writing status updates, blocker reports, or spec summaries that require What/So What/Now What structure."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: code-gc
2
+ name: px-code-gc
3
3
  disable-model-invocation: true
4
4
  description: "Detect code entropy in the current repo: dead code, test debt, stale TODOs, oversized functions, commented-out blocks, unused deps. Two modes: lightweight (called by session-retro) and full audit (manual /code-gc). Never auto-deletes or auto-fixes."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: communication-standards
2
+ name: px-communication-standards
3
3
  description: "Client-facing writing standards. Auto-triggers when writing proposals, status reports, executive summaries, SOWs, deliverable documents, or any content targeting a non-technical audience. Also triggers when writing git commit messages, PR descriptions, or any text where AI attribution must be avoided. Covers executive-summary-first rule, What/So What/Now What structure, proposal format, audience calibration, and no-AI-attribution policy."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: context-probe
2
+ name: px-context-probe
3
3
  disable-model-invocation: true
4
4
  description: "Assess current context health and recommend action. Reads session data and conversation signals to estimate context bracket (FRESH/MODERATE/DEPLETED/CRITICAL)."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: context-reset
2
+ name: px-context-reset
3
3
  disable-model-invocation: true
4
4
  description: Checkpoint current session state to vault files before a context reset. Use when context degradation is detected (repeated corrections, loop behavior, instruction drift).
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: context7-lookup
2
+ name: px-context7-lookup
3
3
  description: "Enforces the docs-first mandate from coding.md. Before implementing with any external library, framework, or API, use Context7 to retrieve current documentation. Activates when code references an external package, imports a third-party library, or calls an API that releases frequently."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: debug
2
+ name: px-debug
3
3
  disable-model-invocation: true
4
4
  description: Structured test-first debugging. Reproduce the bug, write a failing test, isolate root cause, fix, verify. Use for pure bugfixes — skips the full loop.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: deliberate
2
+ name: px-deliberate
3
3
  disable-model-invocation: true
4
4
  description: "Multi-perspective architectural decision making with structured scoring matrix. Use for decisions with multiple valid approaches and hidden trade-offs."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: discover
2
+ name: px-discover
3
3
  disable-model-invocation: true
4
4
  description: Structured technical discovery — evaluate options, make recommendations with confidence levels. Use before /spec when you need to research before deciding.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: discuss
2
+ name: px-discuss
3
3
  disable-model-invocation: true
4
4
  description: Entry point for all feature work. Conversational problem framing — listen first, then synthesize scope. Use before /plan.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: execute
2
+ name: px-execute
3
3
  disable-model-invocation: true
4
4
  description: Implementation phase — loads scoped context and works one milestone at a time. Use after plan is approved.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: fast
2
+ name: px-fast
3
3
  disable-model-invocation: true
4
4
  description: Skip planning for trivial changes. Edit, verify, commit. Use for typos, config tweaks, single-line fixes, and other changes too small for a plan.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: kit
2
+ name: px-kit
3
3
  disable-model-invocation: true
4
4
  description: Activate or deactivate a domain AI-Kit. Use /kit:web-designer to activate, /kit:off to deactivate, /kit:list to show installed kits.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: managing-git-identities
2
+ name: px-managing-git-identities
3
3
  description: "Guides setup and troubleshooting of multiple Git identities (SSH keys, commit author, GitHub CLI auth, includeIf directory routing). Activates when user discusses git accounts, commit identity mismatch, SSH key management, or gh auth switching."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: next
2
+ name: px-next
3
3
  disable-model-invocation: true
4
4
  description: Auto-advance to the next workflow phase. Reads status.md loop_position and plan state to determine what comes next. Use anytime to keep moving.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: plan
2
+ name: px-plan
3
3
  disable-model-invocation: true
4
4
  description: Create a dated work plan for the current project. Writes to vault plans/ directory and updates status.md current_plan field. Use when starting any multi-step task.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: plan-writer
2
+ name: px-plan-writer
3
3
  disable-model-invocation: true
4
4
  description: "Writes a dated work plan to the vault plans/ directory. Creates the plan file with YAML frontmatter, milestones, and acceptance criteria. Updates status.md current_plan field. Called by /plan and /discuss workflows."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: pre-commit-lint
2
+ name: px-pre-commit-lint
3
3
  disable-model-invocation: true
4
4
  description: "Generate a stack-aware pre-commit hook script for a repo. Use when setting up a new repo, when asked to install pre-commit checks, add linting to commits, or wire pre-commit-lint. Also invoked by scaffold-new Phase 5.5. NOT invoked at commit time — generates a shell script that runs at commit time."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: quick
2
+ name: px-quick
3
3
  disable-model-invocation: true
4
4
  description: Ad-hoc task with full quality guarantees in a single compressed flow. Use for tasks that need planning but aren't worth the full loop.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: repair
2
+ name: px-repair
3
3
  disable-model-invocation: true
4
4
  description: "Structured repair phase for failed milestones. 3-attempt fix-and-verify loop with root cause analysis. Triggered by /verify failure or manually."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: research
2
+ name: px-research
3
3
  disable-model-invocation: true
4
4
  description: "Live documentation + security research pipeline. Chains Context7 (docs) and Perplexity Sonar (CVEs, versions, maintenance) into a single structured report."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: review
2
+ name: px-review
3
3
  disable-model-invocation: true
4
4
  description: "Manual code review trigger. Launches a subagent to review a diff for bugs, security, and convention violations. Use independently of Praxis phases."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: risk
2
+ name: px-risk
3
3
  disable-model-invocation: true
4
4
  description: Add a new risk register entry to the current project vault. Assigns a risk ID, severity, mitigation, and writes to specs/risk-register.md.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: scaffold-exist
2
+ name: px-scaffold-exist
3
3
  disable-model-invocation: true
4
4
  description: "Scaffold an existing project into the full harness. Invoke with /scaffold-exist only. Adds missing harness files to projects that predate the scaffold standard. Non-destructive — never overwrites without confirmation. Side-effect skill — never auto-triggers."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: scaffold-new
2
+ name: px-scaffold-new
3
3
  disable-model-invocation: true
4
4
  description: "Scaffold a brand new project into the full harness. Invoke with /scaffold-new only. Creates repo CLAUDE.md, vault subtree, git identity verification, gitignore, pre-commit hook, and Project Registry entry. Side-effect skill — never auto-triggers."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: secret-scan
2
+ name: px-secret-scan
3
3
  description: "Canonical secret scanning skill. Scans files for credential patterns (API keys, tokens, connection strings). Called by pre-commit-lint and ship workflows. Also usable standalone for repo-wide audits. Replaces all inline secret scan regex instances with a single authoritative source."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: session-retro
2
+ name: px-session-retro
3
3
  disable-model-invocation: true
4
4
  description: "End-of-session retrospective. Invoke manually with /session-retro only. Writes [LEARN:tag] entries, proposes rule updates, updates claude-progress.json, triggers vault-gc lightweight check. Side-effect skill — never auto-triggers."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: ship
2
+ name: px-ship
3
3
  disable-model-invocation: true
4
4
  description: Commit, push, and open a PR in one shot. Runs pre-commit checks, crafts a commit message, pushes, and creates a PR with structured description. Use when a milestone or feature is complete and verified.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: simplify
2
+ name: px-simplify
3
3
  disable-model-invocation: true
4
4
  description: "Post-implementation code simplification. Launches a subagent to review recent changes for unnecessary complexity, over-abstraction, and opportunities to simplify. Runs after any implementation phase. Side-effect skill — never auto-triggers."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: spec
2
+ name: px-spec
3
3
  disable-model-invocation: true
4
4
  description: Create a structured spec or ADR for the current project. Writes to vault specs/ directory. Use for architecture decisions, technical designs, and risk documentation — NOT for task framing (use /discuss for that).
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: standup
2
+ name: px-standup
3
3
  disable-model-invocation: true
4
4
  description: Generate a standup summary for the current project. Reads status.md, tasks.md, and active plan. Use at the start or end of any working session.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: status-update
2
+ name: px-status-update
3
3
  disable-model-invocation: true
4
4
  description: "Atomic update to vault status.md. Ensures consistent format, enforces the 100-line limit, and archives resolved items. Called at milestone boundaries, session end, and phase transitions."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: subagent
2
+ name: px-subagent
3
3
  disable-model-invocation: true
4
4
  description: "Reference protocol for subagent dispatch. Defines how to package context, spawn, interpret results, and escalate findings. Not invoked directly — referenced by review, simplify, verify-app, and verify skills."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: sync-memory
2
+ name: px-sync-memory
3
3
  disable-model-invocation: true
4
4
  description: "Bridge auto-memory insights to Obsidian vault. Reads MEMORY.md and topic files, syncs durable entries to vault learnings, prunes stale content. Side-effect skill — never auto-triggers."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: vault-gc
2
+ name: px-vault-gc
3
3
  disable-model-invocation: true
4
4
  description: "Audit vault health and detect entropy. Invoke manually with /vault-gc only. Two modes — full audit (manual) and lightweight staleness check (called inline by session-retro). Never auto-deletes. Side-effect skill — never auto-triggers."
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: verify
2
+ name: px-verify
3
3
  disable-model-invocation: true
4
4
  description: Validation phase — runs test/lint/typecheck/build and reports PASS or FAIL. Use after each milestone completion.
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: verify-app
2
+ name: px-verify-app
3
3
  disable-model-invocation: true
4
4
  description: "End-to-end application verification. Launches a subagent to run the full test suite, check build, verify runtime behavior, and confirm acceptance criteria. Use after implementation to catch integration issues that unit tests miss. Side-effect skill — never auto-triggers."
5
5
  ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@esoteric-logic/praxis-harness",
3
- "version": "2.7.0",
3
+ "version": "2.8.0",
4
4
  "description": "Layered Claude Code harness — workflow discipline, AI-Kits, persistent vault integration",
5
5
  "bin": {
6
6
  "praxis-harness": "./bin/praxis.js"
@@ -94,12 +94,12 @@ echo "Cross-skill references:"
94
94
 
95
95
  # Skills that reference other skills — verify targets exist
96
96
  declare -A SKILL_REFS
97
- SKILL_REFS["verify"]="repair subagent"
98
- SKILL_REFS["review"]="subagent"
99
- SKILL_REFS["simplify"]="subagent"
100
- SKILL_REFS["verify-app"]="subagent"
101
- SKILL_REFS["repair"]="verify"
102
- SKILL_REFS["execute"]="verify discuss"
97
+ SKILL_REFS["px-verify"]="px-repair px-subagent"
98
+ SKILL_REFS["px-review"]="px-subagent"
99
+ SKILL_REFS["px-simplify"]="px-subagent"
100
+ SKILL_REFS["px-verify-app"]="px-subagent"
101
+ SKILL_REFS["px-repair"]="px-verify"
102
+ SKILL_REFS["px-execute"]="px-verify px-discuss"
103
103
 
104
104
  for caller in "${!SKILL_REFS[@]}"; do
105
105
  for target in ${SKILL_REFS[$caller]}; do