@zcy2nn/agent-forge 1.1.3 → 1.1.4
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 +247 -247
- package/agent-forge.schema.json +2 -133
- package/dist/cli/index.js +109 -204
- package/dist/cli/providers.d.ts +0 -44
- package/dist/config/constants.d.ts +3 -4
- package/dist/config/index.d.ts +0 -1
- package/dist/config/schema.d.ts +2 -72
- package/dist/index.js +191 -995
- package/dist/tools/index.d.ts +0 -1
- package/dist/tui.js +5 -18
- package/package.json +104 -104
- package/src/skills/brainstorming/SKILL.md +185 -186
- package/src/skills/brainstorming/scripts/frame-template.html +214 -214
- package/src/skills/brainstorming/scripts/server.cjs +354 -354
- package/src/skills/brainstorming/spec-document-reviewer-prompt.md +1 -1
- package/src/skills/codemap/README.md +3 -3
- package/src/skills/codemap/SKILL.md +5 -5
- package/src/skills/codemap/codemap.md +4 -4
- package/src/skills/codemap/scripts/codemap.mjs +1 -1
- package/src/skills/codemap/scripts/codemap.test.ts +1 -1
- package/src/skills/requesting-code-review/SKILL.md +1 -1
- package/src/skills/subagent-driven-development/SKILL.md +1 -1
- package/src/skills/systematic-debugging/SKILL.md +318 -318
- package/src/skills/test-driven-development/SKILL.md +392 -392
- package/src/skills/verification-before-completion/SKILL.md +153 -153
- package/src/skills/writing-plans/SKILL.md +2 -2
- package/src/skills/writing-skills/graphviz-conventions.dot +171 -171
- package/dist/agents/council.d.ts +0 -27
- package/dist/agents/councillor.d.ts +0 -2
- package/dist/agents/designer.d.ts +0 -2
- package/dist/agents/explorer.d.ts +0 -2
- package/dist/agents/fixer.d.ts +0 -2
- package/dist/agents/implementer.d.ts +0 -2
- package/dist/agents/librarian.d.ts +0 -2
- package/dist/agents/observer.d.ts +0 -2
- package/dist/agents/oracle.d.ts +0 -2
- package/dist/agents/reviewer.d.ts +0 -2
- package/dist/cli/migration.d.ts +0 -46
- package/dist/config/council-schema.d.ts +0 -127
- package/dist/council/council-manager.d.ts +0 -49
- package/dist/council/index.d.ts +0 -1
- package/dist/skills/systematic-debugging/condition-based-waiting-example.d.ts +0 -51
- package/dist/tools/council.d.ts +0 -10
- package/src/skills/using-git-worktrees/SKILL.md +0 -226
|
@@ -4,7 +4,7 @@ Use this template when dispatching a spec document reviewer subagent.
|
|
|
4
4
|
|
|
5
5
|
**Purpose:** Verify the spec is complete, consistent, and ready for implementation planning.
|
|
6
6
|
|
|
7
|
-
**Dispatch after:** Spec document is written to docs/
|
|
7
|
+
**Dispatch after:** Spec document is written to docs/agent-forge/specs/
|
|
8
8
|
|
|
9
9
|
```
|
|
10
10
|
Task tool (general-purpose):
|
|
@@ -7,10 +7,10 @@ Repository understanding and hierarchical codemap generation.
|
|
|
7
7
|
Codemap helps orchestrators map and understand codebases by:
|
|
8
8
|
|
|
9
9
|
1. Selecting relevant code/config files using LLM judgment
|
|
10
|
-
2. Creating `.
|
|
10
|
+
2. Creating `.agf/codemap.json` for change tracking
|
|
11
11
|
3. Generating empty `codemap.md` templates for fixers to fill in
|
|
12
12
|
|
|
13
|
-
Legacy `.
|
|
13
|
+
Legacy `.agf/cartography.json` state is migrated to `.agf/codemap.json` automatically.
|
|
14
14
|
|
|
15
15
|
## Commands
|
|
16
16
|
|
|
@@ -27,7 +27,7 @@ node codemap.mjs update --root /repo
|
|
|
27
27
|
|
|
28
28
|
## Outputs
|
|
29
29
|
|
|
30
|
-
### .
|
|
30
|
+
### .agf/codemap.json
|
|
31
31
|
|
|
32
32
|
```json
|
|
33
33
|
{
|
|
@@ -17,13 +17,13 @@ You help users understand and map repositories by creating hierarchical codemaps
|
|
|
17
17
|
|
|
18
18
|
### Step 1: Check for Existing State
|
|
19
19
|
|
|
20
|
-
**First, check if `.
|
|
20
|
+
**First, check if `.agf/codemap.json` exists in the repo root.**
|
|
21
21
|
|
|
22
|
-
If it does not exist, check for legacy state at `.
|
|
22
|
+
If it does not exist, check for legacy state at `.agf/cartography.json`.
|
|
23
23
|
|
|
24
|
-
If legacy state exists: move `.
|
|
24
|
+
If legacy state exists: move `.agf/cartography.json` to `.agf/codemap.json`, then continue with change detection.
|
|
25
25
|
|
|
26
|
-
If `.
|
|
26
|
+
If `.agf/codemap.json` exists: Skip to Step 3 (Detect Changes) - no need to re-initialize.
|
|
27
27
|
|
|
28
28
|
If neither file exists: Continue to Step 2 (Initialize).
|
|
29
29
|
|
|
@@ -47,7 +47,7 @@ node ~/.config/opencode/skills/codemap/scripts/codemap.mjs init \
|
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
This creates:
|
|
50
|
-
- `.
|
|
50
|
+
- `.agf/codemap.json` - File and folder hashes for change detection
|
|
51
51
|
- Empty `codemap.md` files in all relevant subdirectories
|
|
52
52
|
|
|
53
53
|
4. **Delegate codemap writing to Implementer agents** - Spawn one implementer per folder to read code and create or update its specific `codemap.md` file.
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
- Provide a command-style skill package that standardizes repository mapping workflows for unfamiliar codebases.
|
|
6
6
|
- Define the task contract used by Orchestrator/implementer agents via `SKILL.md` and operational guidance via `README.md`.
|
|
7
|
-
- Generate and evolve change-aware codemap state artifacts (`.
|
|
7
|
+
- Generate and evolve change-aware codemap state artifacts (`.agf/codemap.json`) and scaffold placeholders (`codemap.md`).
|
|
8
8
|
|
|
9
9
|
## Design
|
|
10
10
|
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
- `cmdInit`, `cmdChanges`, `cmdUpdate`
|
|
15
15
|
- `selectFiles`, `computeFileHash`, `computeFolderHash`, `createEmptyCodemap`
|
|
16
16
|
- `loadState`, `saveState`, `migrateLegacyState`
|
|
17
|
-
- Persistence model: JSON state at `.
|
|
17
|
+
- Persistence model: JSON state at `.agf/codemap.json` with `metadata`, `file_hashes`, and `folder_hashes`.
|
|
18
18
|
- Testing layer: `scripts/codemap.test.ts` validates pattern matching, hash determinism, and migration behavior.
|
|
19
19
|
- The script intentionally avoids network and mutates only filesystem-local state and codemap templates.
|
|
20
20
|
|
|
@@ -22,11 +22,11 @@
|
|
|
22
22
|
|
|
23
23
|
- Entry point `main(argv)` parses command and arguments (`init|changes|update`, `--root`, `--include`, `--exclude`, `--exception`) and dispatches via strict branches.
|
|
24
24
|
- `cmdInit()` computes include/exclude candidate sets using `selectFiles()` and writes:
|
|
25
|
-
1) `.
|
|
25
|
+
1) `.agf/codemap.json` via `saveState()`
|
|
26
26
|
2) one `codemap.md` per discovered folder via `createEmptyCodemap()`.
|
|
27
27
|
- `cmdChanges()` reloads state (`loadState()` + `migrateLegacyState()`), recomputes current hashes, emits added/removed/modified diffs and affected folder list, and exits non-zero if state is absent.
|
|
28
28
|
- `cmdUpdate()` recomputes full state from existing metadata and persists it, used after targeted fixers finish updates.
|
|
29
|
-
- `codemap` skill invocation path in SKILL workflow is explicit: Step 1 checks `.
|
|
29
|
+
- `codemap` skill invocation path in SKILL workflow is explicit: Step 1 checks `.agf/codemap.json` or `.agf/cartography.json`, then Step 2/3 selects init or incremental path.
|
|
30
30
|
|
|
31
31
|
## Integration
|
|
32
32
|
|
|
@@ -14,7 +14,7 @@ import path from 'node:path';
|
|
|
14
14
|
import { fileURLToPath } from 'node:url';
|
|
15
15
|
|
|
16
16
|
export const VERSION = '1.0.0';
|
|
17
|
-
export const STATE_DIR = '.
|
|
17
|
+
export const STATE_DIR = '.agf';
|
|
18
18
|
export const STATE_FILE = 'codemap.json';
|
|
19
19
|
export const LEGACY_STATE_FILE = 'cartography.json';
|
|
20
20
|
export const CODEMAP_FILE = 'codemap.md';
|
|
@@ -111,7 +111,7 @@ describe('selectFiles', () => {
|
|
|
111
111
|
describe('loadState', () => {
|
|
112
112
|
test('migrates legacy cartography state', () => {
|
|
113
113
|
const root = createTempDir();
|
|
114
|
-
const slimDir = path.join(root, '.
|
|
114
|
+
const slimDir = path.join(root, '.agf');
|
|
115
115
|
mkdirSync(slimDir);
|
|
116
116
|
|
|
117
117
|
const legacyState = { metadata: { version: '1.0.0' } };
|
|
@@ -58,7 +58,7 @@ HEAD_SHA=$(git rev-parse HEAD)
|
|
|
58
58
|
|
|
59
59
|
[Dispatch superpowers:code-reviewer subagent]
|
|
60
60
|
WHAT_WAS_IMPLEMENTED: Verification and repair functions for conversation index
|
|
61
|
-
PLAN_OR_REQUIREMENTS: Task 2 from docs/
|
|
61
|
+
PLAN_OR_REQUIREMENTS: Task 2 from docs/agent-forge/plans/deployment-plan.md
|
|
62
62
|
BASE_SHA: a7981ec
|
|
63
63
|
HEAD_SHA: 3df7661
|
|
64
64
|
DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types
|
|
@@ -128,7 +128,7 @@ Implementer subagents report one of four statuses. Handle each appropriately:
|
|
|
128
128
|
```
|
|
129
129
|
You: I'm using Subagent-Driven Development to execute this plan.
|
|
130
130
|
|
|
131
|
-
[Read plan file once: docs/
|
|
131
|
+
[Read plan file once: docs/agent-forge/plans/feature-plan.md]
|
|
132
132
|
[Extract all 5 tasks with full text and context]
|
|
133
133
|
[Create TodoWrite with all tasks]
|
|
134
134
|
|