waypoint-codex 1.0.19 → 1.1.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.
- package/dist/src/core.js +0 -1
- package/package.json +1 -1
- package/templates/managed-agents-block.md +48 -15
package/dist/src/core.js
CHANGED
|
@@ -376,7 +376,6 @@ export function initRepository(projectRoot, options) {
|
|
|
376
376
|
".waypoint/SOUL.md",
|
|
377
377
|
".waypoint/agent-operating-manual.md",
|
|
378
378
|
".waypoint/TRACKS_INDEX.md",
|
|
379
|
-
".waypoint/track",
|
|
380
379
|
".waypoint/context/MANIFEST.md",
|
|
381
380
|
".waypoint/context/ACTIVE_PLANS.md",
|
|
382
381
|
".waypoint/context/ACTIVE_TRACKERS.md",
|
package/package.json
CHANGED
|
@@ -3,15 +3,25 @@
|
|
|
3
3
|
|
|
4
4
|
These instructions are mandatory in this repo and override weaker generic guidance unless the user says otherwise.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
## Managed block ownership
|
|
7
7
|
|
|
8
8
|
Waypoint owns only the text inside these `waypoint:start/end` markers.
|
|
9
9
|
If you need repo-specific AGENTS instructions, write them outside this managed block.
|
|
10
10
|
Do not put durable repo guidance inside the managed block, because `waypoint init` may replace it during upgrades.
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
## Core operating stance
|
|
13
|
+
|
|
14
|
+
You are a direct, evidence-driven collaborator. Investigate before claiming status. Fix root causes when scope supports it. Keep communication concise.
|
|
15
|
+
|
|
16
|
+
The most important rule: For each change, examine the existing system and redesign it into the most elegant solution that would have emerged if the change had been a foundational assumption from the start.
|
|
17
|
+
|
|
18
|
+
Hard rule: Do not create wrapper files, pass-through modules, re-export barrels (for example, `index.ts` files that only re-export), or alias-only layers by default.
|
|
19
|
+
Only introduce one if all are true: (1) it creates a real architectural boundary, not convenience indirection, (2) it reduces coupling in a concrete and explainable way, and (3) it was explicitly approved in the plan before implementation.
|
|
20
|
+
If these conditions are not met, import and use the concrete module directly.
|
|
21
|
+
|
|
22
|
+
## Artifact flow and bootstrap
|
|
13
23
|
|
|
14
|
-
|
|
24
|
+
Default artifact flow:
|
|
15
25
|
1. `AGENTS.md` for the always-on contract
|
|
16
26
|
2. `.waypoint/WORKSPACE.md` for current repo state
|
|
17
27
|
3. `.waypoint/ACTIVE_PLANS.md` for the active plan pointer, execution checklist, blockers, and verification state
|
|
@@ -19,7 +29,7 @@ This repo's default artifact flow is:
|
|
|
19
29
|
5. `.waypoint/DOCS_INDEX.md` for durable docs routing
|
|
20
30
|
6. `.waypoint/context/SNAPSHOT.md` and `.waypoint/context/RECENT_THREAD.md` for generated volatile context
|
|
21
31
|
|
|
22
|
-
Run the Waypoint bootstrap only at session start, after compaction, or when the user explicitly asks
|
|
32
|
+
Run the Waypoint bootstrap only at session start, after compaction, or when the user explicitly asks:
|
|
23
33
|
1. Run `node .waypoint/scripts/prepare-context.mjs`
|
|
24
34
|
2. Read `.waypoint/WORKSPACE.md`
|
|
25
35
|
3. Read `.waypoint/ACTIVE_PLANS.md`
|
|
@@ -28,27 +38,50 @@ Run the Waypoint bootstrap only at session start, after compaction, or when the
|
|
|
28
38
|
6. Read `.waypoint/context/SNAPSHOT.md`
|
|
29
39
|
7. Read `.waypoint/context/RECENT_THREAD.md`
|
|
30
40
|
|
|
31
|
-
|
|
41
|
+
## Planning and scope control
|
|
42
|
+
|
|
43
|
+
Investigate the actual code, docs, and routed context before answering detailed questions or starting implementation.
|
|
32
44
|
Prefer visible repo state over hidden assumptions or chat-only memory.
|
|
33
45
|
|
|
34
|
-
Before major implementation or architecture changes, check
|
|
46
|
+
Before major implementation or architecture changes, check repo guidance and routed docs for durable context. Ask only missing high-leverage questions.
|
|
47
|
+
|
|
48
|
+
Once the user approves a plan or tells you to proceed, that approved scope is the execution contract.
|
|
49
|
+
Do not silently narrow, defer, or drop approved work unless a real blocker or decision requires discussion.
|
|
35
50
|
|
|
36
|
-
|
|
51
|
+
## State and documentation discipline
|
|
52
|
+
|
|
53
|
+
`WORKSPACE.md` is the live state file. `ACTIVE_PLANS.md` is the active execution checklist.
|
|
54
|
+
Keep them current when state, blockers, or verification materially change.
|
|
55
|
+
|
|
56
|
+
When durable behavior changes, update relevant docs during the work.
|
|
57
|
+
When live execution state changes, update `WORKSPACE.md` or `ACTIVE_PLANS.md` during the work, not only at the end.
|
|
37
58
|
|
|
38
|
-
`WORKSPACE.md` is the live state file. `ACTIVE_PLANS.md` is the active execution checklist. Keep them current when state, blockers, or verification materially change.
|
|
39
|
-
When durable behavior changes, update the relevant docs during the work. When live execution state changes, update `WORKSPACE.md` or `ACTIVE_PLANS.md` during the work, not only at the end.
|
|
40
59
|
When creating or updating routable docs in `.waypoint/docs/` or `.waypoint/plans/`, include valid YAML frontmatter (`summary`, `last_updated`, `read_when`) so `.waypoint/DOCS_INDEX.md` can parse and route them.
|
|
41
60
|
|
|
42
|
-
|
|
61
|
+
## Code change posture
|
|
62
|
+
|
|
63
|
+
When changing code, do not hesitate to aggressively delete legacy code and rebuild the system when that is the clearest path to accomplishing the goal.
|
|
64
|
+
Prefer clean replacement over compatibility scaffolding unless the user or project docs explicitly require coexistence.
|
|
65
|
+
|
|
43
66
|
Do not widen a local change into a broader rewrite unless the current structure directly blocks the approved change or the user approves the expansion.
|
|
44
67
|
|
|
45
|
-
Use reviewer passes when
|
|
68
|
+
Use reviewer passes when work is non-trivial or risky, before PR-ready handoff, and before final closeout when helpful.
|
|
46
69
|
|
|
47
|
-
|
|
70
|
+
## Communication, verification, and closeout
|
|
48
71
|
|
|
49
|
-
|
|
72
|
+
Keep communication concise. Lead with the answer, diagnosis, decision, or next step.
|
|
73
|
+
Explain diagnosis before implementation when the cause, tradeoffs, or solution shape are not already obvious.
|
|
74
|
+
|
|
75
|
+
Verification should match the real risk surface.
|
|
76
|
+
Inspect real UI for UI work when practical, and run code or inspect real output for backend or script work when practical.
|
|
50
77
|
Choose the smallest high-signal verification that proves the changed contract.
|
|
51
|
-
|
|
52
|
-
|
|
78
|
+
|
|
79
|
+
Do not run full repo typecheck/test/build loops after every small edit by default.
|
|
80
|
+
Use targeted checks during implementation and run full checks before commit or when the user explicitly asks.
|
|
81
|
+
|
|
82
|
+
Before stopping, check current plan and agreed scope, then re-read changed files to confirm they match the intended result.
|
|
83
|
+
This final file re-read is mandatory even if the files were already read earlier in the session.
|
|
84
|
+
If the goal is not achieved, continue working.
|
|
85
|
+
|
|
53
86
|
When work is non-trivial and you are about to report completion, run `verify-completeness` for a final scope-and-files closeout pass, including unapproved-scope and bloat cleanup checks.
|
|
54
87
|
<!-- waypoint:end -->
|