@artale/pi-real-engineering 0.1.0 → 0.2.1
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/README.md
CHANGED
|
@@ -1,36 +1,59 @@
|
|
|
1
1
|
# @artale/pi-real-engineering
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Plan → Build → Test → Review → Ship for Pi, with verifier guardrails and receipts.
|
|
4
|
+
|
|
5
|
+
This is not a loose skills pack. It installs one workflow command plus the small skills that make the loop work.
|
|
4
6
|
|
|
5
7
|
## Install
|
|
6
8
|
|
|
7
9
|
```bash
|
|
8
10
|
pi install npm:@artale/pi-real-engineering
|
|
11
|
+
/reload
|
|
9
12
|
```
|
|
10
13
|
|
|
11
|
-
|
|
14
|
+
## Golden path
|
|
12
15
|
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
/reload
|
|
16
|
+
```text
|
|
17
|
+
idea → safety gate → ADW plan/build/test/review → receipt → guarded deploy
|
|
16
18
|
```
|
|
17
19
|
|
|
18
|
-
|
|
20
|
+
Run it:
|
|
19
21
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
| `grill-with-docs` | user | Interview the user against docs/context before implementation |
|
|
24
|
-
| `tdd` | model | Red-green-refactor one vertical slice at a time |
|
|
25
|
-
| `diagnosing-bugs` | model | Reproduce, minimize, hypothesize, instrument, fix |
|
|
26
|
-
| `domain-modeling` | model | Maintain shared language in `CONTEXT.md` and ADRs |
|
|
27
|
-
| `codebase-design` | model | Design deep modules with small interfaces and clean seams |
|
|
28
|
-
|
|
29
|
-
## Conventions
|
|
22
|
+
```text
|
|
23
|
+
/real-engineering build the smallest safe version of <idea>
|
|
24
|
+
```
|
|
30
25
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
26
|
+
The command makes Pi:
|
|
27
|
+
|
|
28
|
+
1. restate the idea
|
|
29
|
+
2. run a safety gate before risky writes/commands/deploys
|
|
30
|
+
3. plan/build/test/review in the smallest useful loop
|
|
31
|
+
4. produce a receipt: changed files, commands run, test output, review result, deploy decision
|
|
32
|
+
5. deploy only when explicitly requested and verified
|
|
33
|
+
|
|
34
|
+
## Included skills
|
|
35
|
+
|
|
36
|
+
| Skill | Purpose |
|
|
37
|
+
|---|---|
|
|
38
|
+
| `setup-artale-skills` | Create repo conventions: `AGENTS.md`, `CONTEXT.md`, `docs/adr/`, `.pi/plans/` |
|
|
39
|
+
| `grill-with-docs` | Interview against docs/context before implementation |
|
|
40
|
+
| `tdd` | Red-green-refactor one vertical slice at a time |
|
|
41
|
+
| `diagnosing-bugs` | Reproduce, minimize, hypothesize, instrument, fix |
|
|
42
|
+
| `domain-modeling` | Maintain shared language in `CONTEXT.md` and ADRs |
|
|
43
|
+
| `codebase-design` | Design deep modules with small interfaces and clean seams |
|
|
44
|
+
|
|
45
|
+
## Receipt format
|
|
46
|
+
|
|
47
|
+
```md
|
|
48
|
+
## Real Engineering Receipt
|
|
49
|
+
- Idea:
|
|
50
|
+
- Safety gate:
|
|
51
|
+
- Plan:
|
|
52
|
+
- Changed files:
|
|
53
|
+
- Commands run:
|
|
54
|
+
- Test output:
|
|
55
|
+
- Review result:
|
|
56
|
+
- Deploy decision:
|
|
57
|
+
```
|
|
35
58
|
|
|
36
|
-
No
|
|
59
|
+
No new infra. The workflow uses Pi commands, verifier discipline, and your existing deploy path.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# RSI recovery receipt — 2026-06-19T09:37:24Z
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
Prove the recursive self-improvement loop with a harmless degraded skill.
|
|
5
|
+
|
|
6
|
+
## Setup
|
|
7
|
+
- Target: engine VPS `hermes` container
|
|
8
|
+
- Canary: `/opt/data/skills/rsi_canary/test.sh`
|
|
9
|
+
- Repair: `/opt/data/skills/rsi_canary/repair.sh`
|
|
10
|
+
|
|
11
|
+
## Command
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
docker exec hermes python3 /tmp/skill_health.py --auto-patch
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Evidence
|
|
18
|
+
|
|
19
|
+
```text
|
|
20
|
+
❌ rsi_canary
|
|
21
|
+
RSI: 65/66 (98%)
|
|
22
|
+
Degraded: ['rsi_canary']
|
|
23
|
+
🔄 ZTE: auto-patching 1 degraded skills
|
|
24
|
+
📸 Snap: 20260619_093724
|
|
25
|
+
Fixing rsi_canary...
|
|
26
|
+
Local repair: rc=0 rsi_canary: repair applied
|
|
27
|
+
✅ All patched successfully
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Final check
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
docker exec hermes bash -lc /opt/data/skills/rsi_canary/test.sh
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
```text
|
|
37
|
+
rsi_canary: recovered
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Result
|
|
41
|
+
PASS — watcher detected a degraded harmless skill, auto-patch ran, and a final check proved recovery.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
|
|
3
|
+
export default function (pi: ExtensionAPI) {
|
|
4
|
+
pi.registerCommand("real-engineering", {
|
|
5
|
+
description: "Run the real engineering golden path: safety gate → ADW → receipt → guarded deploy.",
|
|
6
|
+
prompt: `Run the Real Engineering Workflow for Pi.
|
|
7
|
+
|
|
8
|
+
Golden path:
|
|
9
|
+
idea → safety gate → ADW plan/build/test/review → receipt → guarded deploy
|
|
10
|
+
|
|
11
|
+
Rules:
|
|
12
|
+
1. Stop adding features outside the requested idea.
|
|
13
|
+
2. Safety gate first: identify risky writes/commands/deploys and ask before dangerous actions.
|
|
14
|
+
3. Use the smallest ADW loop that fits: plan → build → test → review.
|
|
15
|
+
4. Produce a receipt with: changed files, commands run, test output, review result, deploy decision.
|
|
16
|
+
5. Guarded deploy only if checks actually passed. If deploy is not requested or not verified, say so.
|
|
17
|
+
|
|
18
|
+
Start by restating the idea and the safety gate.`,
|
|
19
|
+
});
|
|
20
|
+
}
|
package/package.json
CHANGED
|
@@ -1,15 +1,34 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@artale/pi-real-engineering",
|
|
3
|
-
"version": "0.1
|
|
4
|
-
"description": "
|
|
5
|
-
"license": "MIT",
|
|
6
|
-
"type": "module",
|
|
7
|
-
"keywords": [
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
"
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
"
|
|
14
|
-
|
|
15
|
-
|
|
1
|
+
{
|
|
2
|
+
"name": "@artale/pi-real-engineering",
|
|
3
|
+
"version": "0.2.1",
|
|
4
|
+
"description": "Real Engineering Workflow for Pi: Plan \u2192 Build \u2192 Test \u2192 Review \u2192 Ship with verifier guardrails and receipts.",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"keywords": [
|
|
8
|
+
"pi-package",
|
|
9
|
+
"pi",
|
|
10
|
+
"pi-extension",
|
|
11
|
+
"pi-skill",
|
|
12
|
+
"real-engineering",
|
|
13
|
+
"adw",
|
|
14
|
+
"verifier",
|
|
15
|
+
"receipts"
|
|
16
|
+
],
|
|
17
|
+
"files": [
|
|
18
|
+
"README.md",
|
|
19
|
+
"extensions/**/*",
|
|
20
|
+
"skills/**/*",
|
|
21
|
+
"docs/receipts/**/*"
|
|
22
|
+
],
|
|
23
|
+
"peerDependencies": {
|
|
24
|
+
"@earendil-works/pi-coding-agent": "*"
|
|
25
|
+
},
|
|
26
|
+
"pi": {
|
|
27
|
+
"extensions": [
|
|
28
|
+
"./extensions"
|
|
29
|
+
],
|
|
30
|
+
"skills": [
|
|
31
|
+
"./skills"
|
|
32
|
+
]
|
|
33
|
+
}
|
|
34
|
+
}
|
|
@@ -1,50 +1,50 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: setup-artale-skills
|
|
3
|
-
description: Configure a repo for Artale real-engineering skills: AGENTS.md rules, issue workflow, CONTEXT.md, ADRs, and .pi/plans. User-invoked setup procedure.
|
|
4
|
-
disable-model-invocation: true
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Setup Artale Skills
|
|
8
|
-
|
|
9
|
-
Prompt-driven setup. Explore first, ask before writing, then make the smallest durable conventions.
|
|
10
|
-
|
|
11
|
-
## Explore
|
|
12
|
-
|
|
13
|
-
Check:
|
|
14
|
-
|
|
15
|
-
- `git remote -v` / `.git/config`
|
|
16
|
-
- `AGENTS.md`, `CLAUDE.md`
|
|
17
|
-
- `CONTEXT.md`, `CONTEXT-MAP.md`
|
|
18
|
-
- `docs/adr/`
|
|
19
|
-
- `docs/agents/`
|
|
20
|
-
- `.pi/plans/`
|
|
21
|
-
|
|
22
|
-
## Ask one decision at a time
|
|
23
|
-
|
|
24
|
-
1. **Issue workflow**: GitHub (`gh`), GitLab (`glab`), local markdown, or other.
|
|
25
|
-
2. **Docs layout**: single-context `CONTEXT.md` or multi-context `CONTEXT-MAP.md`.
|
|
26
|
-
3. **Verifier strictness**: strict by default; PASS requires real checks.
|
|
27
|
-
|
|
28
|
-
## Write
|
|
29
|
-
|
|
30
|
-
Prefer `AGENTS.md`. If only `CLAUDE.md` exists, update it for compatibility. Do not create both unless the user asks.
|
|
31
|
-
|
|
32
|
-
Create lazily:
|
|
33
|
-
|
|
34
|
-
- `CONTEXT.md`
|
|
35
|
-
- `docs/adr/`
|
|
36
|
-
- `.pi/plans/`
|
|
37
|
-
- `docs/agents/issue-tracker.md`
|
|
38
|
-
- `docs/agents/domain.md`
|
|
39
|
-
|
|
40
|
-
## Agent skills block
|
|
41
|
-
|
|
42
|
-
```md
|
|
43
|
-
## Agent skills
|
|
44
|
-
|
|
45
|
-
- Use `CONTEXT.md` for domain language before planning.
|
|
46
|
-
- Use `docs/adr/` for durable architectural decisions.
|
|
47
|
-
- Use `.pi/plans/` for temporary plans/spikes.
|
|
48
|
-
- Use `tdd` for behavior changes, `diagnosing-bugs` for bugs, `codebase-design` for module/interface work.
|
|
49
|
-
- Do not return PASS unless checks actually ran.
|
|
50
|
-
```
|
|
1
|
+
---
|
|
2
|
+
name: setup-artale-skills
|
|
3
|
+
description: "Configure a repo for Artale real-engineering skills: AGENTS.md rules, issue workflow, CONTEXT.md, ADRs, and .pi/plans. User-invoked setup procedure."
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Setup Artale Skills
|
|
8
|
+
|
|
9
|
+
Prompt-driven setup. Explore first, ask before writing, then make the smallest durable conventions.
|
|
10
|
+
|
|
11
|
+
## Explore
|
|
12
|
+
|
|
13
|
+
Check:
|
|
14
|
+
|
|
15
|
+
- `git remote -v` / `.git/config`
|
|
16
|
+
- `AGENTS.md`, `CLAUDE.md`
|
|
17
|
+
- `CONTEXT.md`, `CONTEXT-MAP.md`
|
|
18
|
+
- `docs/adr/`
|
|
19
|
+
- `docs/agents/`
|
|
20
|
+
- `.pi/plans/`
|
|
21
|
+
|
|
22
|
+
## Ask one decision at a time
|
|
23
|
+
|
|
24
|
+
1. **Issue workflow**: GitHub (`gh`), GitLab (`glab`), local markdown, or other.
|
|
25
|
+
2. **Docs layout**: single-context `CONTEXT.md` or multi-context `CONTEXT-MAP.md`.
|
|
26
|
+
3. **Verifier strictness**: strict by default; PASS requires real checks.
|
|
27
|
+
|
|
28
|
+
## Write
|
|
29
|
+
|
|
30
|
+
Prefer `AGENTS.md`. If only `CLAUDE.md` exists, update it for compatibility. Do not create both unless the user asks.
|
|
31
|
+
|
|
32
|
+
Create lazily:
|
|
33
|
+
|
|
34
|
+
- `CONTEXT.md`
|
|
35
|
+
- `docs/adr/`
|
|
36
|
+
- `.pi/plans/`
|
|
37
|
+
- `docs/agents/issue-tracker.md`
|
|
38
|
+
- `docs/agents/domain.md`
|
|
39
|
+
|
|
40
|
+
## Agent skills block
|
|
41
|
+
|
|
42
|
+
```md
|
|
43
|
+
## Agent skills
|
|
44
|
+
|
|
45
|
+
- Use `CONTEXT.md` for domain language before planning.
|
|
46
|
+
- Use `docs/adr/` for durable architectural decisions.
|
|
47
|
+
- Use `.pi/plans/` for temporary plans/spikes.
|
|
48
|
+
- Use `tdd` for behavior changes, `diagnosing-bugs` for bugs, `codebase-design` for module/interface work.
|
|
49
|
+
- Do not return PASS unless checks actually ran.
|
|
50
|
+
```
|