@plainconceptsplatform/agent-harness 2.4.0 → 2.4.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.
|
@@ -9,7 +9,7 @@ When the plan lives in the Todo pane (from `/plan-quick`) and no OpenSpec change
|
|
|
9
9
|
- Mark it `in_progress` via `todowrite`.
|
|
10
10
|
- Implement it (edit files, run commands as needed).
|
|
11
11
|
- Mark it `completed` via `todowrite`.
|
|
12
|
-
- Commit the change: `git add
|
|
12
|
+
- Commit the change: `git add <the paths this task wrote> && git commit -m "task {id}: {summary}"`. Never `-A` or `.`: a working tree is shared, and staging all of it commits somebody else's edits, possibly half-finished, under your message.
|
|
13
13
|
4. After all tasks are done, run the project's typecheck/build check if one exists. Fix any errors.
|
|
14
14
|
5. Report: tasks N/N completed, commits made, branch name.
|
|
15
15
|
|
|
@@ -12,7 +12,9 @@ Keep this checklist visible:
|
|
|
12
12
|
|
|
13
13
|
Move forward only when a phase returns its required result. On a hard failure, follow the [failure policy](failure-policy.md). Continue after each phase skill returns; the run ends only after every checklist item is complete.
|
|
14
14
|
|
|
15
|
-
**Token efficiency rules:** Batch git operations within a phase (combine `git add
|
|
15
|
+
**Token efficiency rules:** Batch git operations within a phase (combine `git add <paths> && git commit` in one tool call). Do not run status checks between sequential operations in the same phase. Minimize model turns: if a phase requires 3 git commands, call them in one tool call, not 3.
|
|
16
|
+
|
|
17
|
+
**Stage paths, never `git add -A` or `git add .`.** A working tree is shared: a person or another agent may have edits in it, and staging everything puts their work in your commit under your message. It is not hypothetical. A Teams tool and its tests were committed inside a commit named after a YAML input rename, and nothing in that message said so. Two things go wrong, and the second is worse: the history lies about what changed, and unreviewed or half-finished work reaches the default branch under a heading nobody would look twice at. Saving a model turn is not worth either.
|
|
16
18
|
|
|
17
19
|
Input: `$ARGUMENTS`
|
|
18
20
|
|
|
@@ -44,14 +46,14 @@ Tick `explore` when `pc-plan-explore` returns its findings handoff.
|
|
|
44
46
|
|
|
45
47
|
## Phase 3: Propose
|
|
46
48
|
|
|
47
|
-
**Skip if `{refined}` is `true`.** Instead, create a minimal OpenSpec change directly: run `openspec new change "{change-id}"`, write `tasks.md` from the issue's acceptance criteria (one task per criterion or artifact group), create `.openspec.yaml` with `skip_specs: true` (the issue already has the spec content), and commit: `git add -
|
|
49
|
+
**Skip if `{refined}` is `true`.** Instead, create a minimal OpenSpec change directly: run `openspec new change "{change-id}"`, write `tasks.md` from the issue's acceptance criteria (one task per criterion or artifact group), create `.openspec.yaml` with `skip_specs: true` (the issue already has the spec content), and commit: `git add openspec/changes/{change-id}/ && git commit -m "propose: {title} ({change-id})"`.
|
|
48
50
|
|
|
49
51
|
Load `pc-plan-propose` in autonomous mode with `{resolved_input}`, `EXPLORATION_BRIEF`, and `scope_classification`.
|
|
50
52
|
|
|
51
53
|
Confirm its change directory and actionable `tasks.md` exist. Rename `$BRANCH` when the canonical change slug differs from `{slug}`, then commit the proposal:
|
|
52
54
|
|
|
53
55
|
```bash
|
|
54
|
-
git add -
|
|
56
|
+
git add openspec/changes/{change-id}/ && git commit -m "propose: {title} ({change-id})"
|
|
55
57
|
```
|
|
56
58
|
|
|
57
59
|
Tick `propose` when the proposal commit exists.
|
|
@@ -69,7 +71,7 @@ Require `verify` and a clean working tree. Load `pc-plan-archive` in autonomous
|
|
|
69
71
|
Require `ARCHIVED_OK` and the archive path, then commit:
|
|
70
72
|
|
|
71
73
|
```bash
|
|
72
|
-
git add
|
|
74
|
+
git add openspec/changes/ && git commit -m "archive: {title} ({change-id})"
|
|
73
75
|
```
|
|
74
76
|
|
|
75
77
|
Tick `archive` when the archive commit exists.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plainconceptsplatform/agent-harness",
|
|
3
|
-
"version": "2.4.
|
|
3
|
+
"version": "2.4.1",
|
|
4
4
|
"description": "Installs the Plain Concepts Platform Harness into any codebase, and keeps it up to date. Wires OpenCode, OpenSpec, codegraph, and agentmemory into a multi-agent workflow that runs on native parallel subagents.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"opencode",
|