@hanhnd/agent-kit 1.0.15 → 1.0.17
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 +53 -15
- package/dist/kit-server.js +222 -222
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,21 +6,59 @@
|
|
|
6
6
|
|
|
7
7
|
### Commands
|
|
8
8
|
|
|
9
|
-
| Command
|
|
10
|
-
|
|
|
11
|
-
| `/ak:brainstorm [idea]`
|
|
12
|
-
| `/ak:plan [file or idea]`
|
|
13
|
-
| `/ak:code [file or task]`
|
|
14
|
-
| `/ak:code-simplify`
|
|
15
|
-
| `/ak:research [topic]`
|
|
16
|
-
| `/ak:review-pr [PR URL]`
|
|
17
|
-
| `/ak:review`
|
|
18
|
-
| `/ak:debate [subject]`
|
|
19
|
-
| `/ak:ticket [ID]`
|
|
20
|
-
| `/ak:git`
|
|
21
|
-
| `/ak:init`
|
|
22
|
-
| `/ak:orchestrate [file or idea]`
|
|
23
|
-
| `/ak:delegate <agent> <task>`
|
|
9
|
+
| Command | Description |
|
|
10
|
+
| --------------------------------- | ------------------------------------------------------------------ |
|
|
11
|
+
| `/ak:brainstorm [idea]` | Strategic architectural analysis |
|
|
12
|
+
| `/ak:plan [file or idea]` | Create an implementation blueprint |
|
|
13
|
+
| `/ak:code [file or task]` | Implement from a plan |
|
|
14
|
+
| `/ak:code-simplify` | Refactor modified code for readability |
|
|
15
|
+
| `/ak:research [topic]` | Research a topic |
|
|
16
|
+
| `/ak:review-pr [PR URL]` | Review a pull request |
|
|
17
|
+
| `/ak:review` | Review uncommitted local changes |
|
|
18
|
+
| `/ak:debate [subject]` | Run adversarial debate (Gilfoyle vs Dinesh vs Judge) |
|
|
19
|
+
| `/ak:ticket [ID]` | Fetch a Jira ticket and plan from it |
|
|
20
|
+
| `/ak:git` | Git commit, branch, and PR workflow |
|
|
21
|
+
| `/ak:init` | Create the project overview file |
|
|
22
|
+
| `/ak:orchestrate [file or idea]` | Orchestrate agents to solve problems span across multiple projects |
|
|
23
|
+
| `/ak:delegate <agent> <task>` | Delegate a task to Gemini or Claude CLI |
|
|
24
|
+
| `/ak:wiki [compile\|query\|lint]` | Maintain a persistent, compounding project knowledge wiki |
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## Wiki
|
|
29
|
+
|
|
30
|
+
The wiki is a persistent, compounding knowledge base that accumulates architectural decisions, feature history, patterns, and edge cases across sessions. Unlike conversation memory (which resets), the wiki survives compaction, restarts, and new sessions — it is the long-term institutional memory of your project.
|
|
31
|
+
|
|
32
|
+
### How It's Auto-Populated (Hooks)
|
|
33
|
+
|
|
34
|
+
You don't need to run the wiki manually. Five hooks keep it fed automatically:
|
|
35
|
+
|
|
36
|
+
- **PostToolUse** — every `kit_save_handoff` call is automatically logged to `.agent-kit/wiki/raw/inbox.md`
|
|
37
|
+
- **PreCompact** — before `/compact` discards context, the full session transcript is exported to `.agent-kit/wiki/raw/`
|
|
38
|
+
- **PostCompact** — after compaction, the wiki index is re-injected as context so the very next turn has full project knowledge
|
|
39
|
+
- **SessionEnd** — before session is cleared, the conversation transcript is exported to `.agent-kit/wiki/raw/`
|
|
40
|
+
- **SessionStart (clear)** — after `/clear` resets the session, the wiki index is re-injected so the fresh session starts with full project knowledge
|
|
41
|
+
|
|
42
|
+
### Operations
|
|
43
|
+
|
|
44
|
+
| Command | Description |
|
|
45
|
+
| -------------------------------- | --------------------------------------------------------------------- |
|
|
46
|
+
| `/ak:wiki` or `/ak:wiki compile` | Ingest raw inbox + conversation exports → build/update wiki pages |
|
|
47
|
+
| `/ak:wiki query {question}` | Search the wiki and synthesize a cited answer |
|
|
48
|
+
| `/ak:wiki lint` | Health-check: broken links, orphan pages, contradictions, stale inbox |
|
|
49
|
+
|
|
50
|
+
### Directory Structure
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
.agent-kit/wiki/
|
|
54
|
+
├── raw/
|
|
55
|
+
│ ├── inbox.md # Auto-appended by PostToolUse hook (handoff logs)
|
|
56
|
+
│ └── conv_*.md # Exported by PreCompact hook (conversation transcripts)
|
|
57
|
+
├── compiled/
|
|
58
|
+
│ └── *.md # Structured wiki pages built by /ak:wiki compile
|
|
59
|
+
└── archive/
|
|
60
|
+
└── *.md # Old raw files moved here after compilation
|
|
61
|
+
```
|
|
24
62
|
|
|
25
63
|
---
|
|
26
64
|
|