tribunal-kit 4.4.2 โ 4.4.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/.agent/scripts/marathon_harness.js +896 -0
- package/.agent/scripts/prompt_compiler.js +87 -0
- package/.agent/skills/agent-organizer/SKILL.md +42 -0
- package/.agent/skills/agentic-patterns/SKILL.md +42 -0
- package/.agent/skills/ai-prompt-injection-defense/SKILL.md +42 -0
- package/.agent/skills/api-patterns/SKILL.md +42 -0
- package/.agent/skills/api-security-auditor/SKILL.md +42 -0
- package/.agent/skills/app-builder/SKILL.md +42 -0
- package/.agent/skills/appflow-wireframe/SKILL.md +42 -0
- package/.agent/skills/architecture/SKILL.md +42 -0
- package/.agent/skills/authentication-best-practices/SKILL.md +42 -0
- package/.agent/skills/backend-security-expert/SKILL.md +122 -0
- package/.agent/skills/bash-linux/SKILL.md +42 -0
- package/.agent/skills/behavioral-modes/SKILL.md +42 -0
- package/.agent/skills/brainstorming/SKILL.md +42 -0
- package/.agent/skills/building-native-ui/SKILL.md +42 -0
- package/.agent/skills/clean-code/SKILL.md +42 -0
- package/.agent/skills/code-review-checklist/SKILL.md +42 -0
- package/.agent/skills/config-validator/SKILL.md +42 -0
- package/.agent/skills/csharp-developer/SKILL.md +42 -0
- package/.agent/skills/data-validation-schemas/SKILL.md +42 -0
- package/.agent/skills/database-design/SKILL.md +42 -0
- package/.agent/skills/deployment-procedures/SKILL.md +42 -0
- package/.agent/skills/devops-engineer/SKILL.md +42 -0
- package/.agent/skills/devops-incident-responder/SKILL.md +42 -0
- package/.agent/skills/documentation-templates/SKILL.md +42 -0
- package/.agent/skills/edge-computing/SKILL.md +42 -0
- package/.agent/skills/error-resilience/SKILL.md +42 -0
- package/.agent/skills/extract-design-system/SKILL.md +42 -0
- package/.agent/skills/framer-motion-expert/SKILL.md +42 -0
- package/.agent/skills/frontend-design/SKILL.md +42 -0
- package/.agent/skills/frontend-security-expert/SKILL.md +123 -0
- package/.agent/skills/game-design-expert/SKILL.md +42 -0
- package/.agent/skills/game-engineering-expert/SKILL.md +42 -0
- package/.agent/skills/geo-fundamentals/SKILL.md +42 -0
- package/.agent/skills/github-operations/SKILL.md +42 -0
- package/.agent/skills/gsap-core/SKILL.md +42 -0
- package/.agent/skills/gsap-frameworks/SKILL.md +42 -0
- package/.agent/skills/gsap-performance/SKILL.md +42 -0
- package/.agent/skills/gsap-plugins/SKILL.md +42 -0
- package/.agent/skills/gsap-react/SKILL.md +42 -0
- package/.agent/skills/gsap-scrolltrigger/SKILL.md +42 -0
- package/.agent/skills/gsap-timeline/SKILL.md +42 -0
- package/.agent/skills/gsap-utils/SKILL.md +42 -0
- package/.agent/skills/i18n-localization/SKILL.md +42 -0
- package/.agent/skills/intelligent-routing/SKILL.md +42 -0
- package/.agent/skills/knowledge-graph/SKILL.md +42 -0
- package/.agent/skills/lint-and-validate/SKILL.md +42 -0
- package/.agent/skills/llm-engineering/SKILL.md +42 -0
- package/.agent/skills/local-first/SKILL.md +42 -0
- package/.agent/skills/mcp-builder/SKILL.md +42 -0
- package/.agent/skills/mobile-design/SKILL.md +42 -0
- package/.agent/skills/monorepo-management/SKILL.md +42 -0
- package/.agent/skills/motion-engineering/SKILL.md +42 -0
- package/.agent/skills/nextjs-react-expert/SKILL.md +42 -0
- package/.agent/skills/nodejs-best-practices/SKILL.md +42 -0
- package/.agent/skills/observability/SKILL.md +42 -0
- package/.agent/skills/parallel-agents/SKILL.md +42 -0
- package/.agent/skills/performance-profiling/SKILL.md +42 -0
- package/.agent/skills/plan-writing/SKILL.md +42 -0
- package/.agent/skills/platform-engineer/SKILL.md +42 -0
- package/.agent/skills/playwright-best-practices/SKILL.md +42 -0
- package/.agent/skills/powershell-windows/SKILL.md +42 -0
- package/.agent/skills/project-idioms/SKILL.md +42 -0
- package/.agent/skills/python-patterns/SKILL.md +42 -0
- package/.agent/skills/python-pro/SKILL.md +42 -0
- package/.agent/skills/react-specialist/SKILL.md +42 -0
- package/.agent/skills/readme-builder/SKILL.md +42 -0
- package/.agent/skills/realtime-patterns/SKILL.md +42 -0
- package/.agent/skills/red-team-tactics/SKILL.md +42 -0
- package/.agent/skills/rust-pro/SKILL.md +42 -0
- package/.agent/skills/seo-fundamentals/SKILL.md +42 -0
- package/.agent/skills/server-management/SKILL.md +42 -0
- package/.agent/skills/shadcn-ui-expert/SKILL.md +42 -0
- package/.agent/skills/skill-creator/SKILL.md +42 -0
- package/.agent/skills/sql-pro/SKILL.md +42 -0
- package/.agent/skills/supabase-postgres-best-practices/SKILL.md +42 -0
- package/.agent/skills/swiftui-expert/SKILL.md +42 -0
- package/.agent/skills/systematic-debugging/SKILL.md +42 -0
- package/.agent/skills/tailwind-patterns/SKILL.md +42 -0
- package/.agent/skills/tdd-workflow/SKILL.md +42 -0
- package/.agent/skills/test-result-analyzer/SKILL.md +42 -0
- package/.agent/skills/testing-patterns/SKILL.md +42 -0
- package/.agent/skills/trend-researcher/SKILL.md +42 -0
- package/.agent/skills/typescript-advanced/SKILL.md +42 -0
- package/.agent/skills/ui-ux-pro-max/SKILL.md +42 -0
- package/.agent/skills/ui-ux-researcher/SKILL.md +42 -0
- package/.agent/skills/vue-expert/SKILL.md +42 -0
- package/.agent/skills/vulnerability-scanner/SKILL.md +42 -0
- package/.agent/skills/web-accessibility-auditor/SKILL.md +42 -0
- package/.agent/skills/web-design-guidelines/SKILL.md +42 -0
- package/.agent/skills/webapp-testing/SKILL.md +42 -0
- package/.agent/skills/whimsy-injector/SKILL.md +42 -0
- package/.agent/skills/workflow-optimizer/SKILL.md +42 -0
- package/.agent/workflows/marathon.md +247 -0
- package/.agent/workflows/super-prompt.md +27 -0
- package/README.md +113 -242
- package/bin/tribunal-kit.js +49 -3
- package/package.json +3 -2
- package/.agent/scripts/append_flow.js +0 -72
- package/.agent/scripts/colors.js +0 -11
- package/.agent/scripts/compress_skills.js +0 -141
- package/.agent/scripts/consolidate_skills.js +0 -149
- package/.agent/scripts/deep_compress.js +0 -150
- package/.agent/scripts/patch_skills_meta.js +0 -156
- package/.agent/scripts/patch_skills_output.js +0 -244
- package/.agent/scripts/strip_tribunal.js +0 -47
- package/.agent/scripts/utils.js +0 -17
|
@@ -0,0 +1,247 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Long-running agent harness for multi-session projects. Decomposes specs into atomic features tracked in JSON, ensures clean handoffs between sessions, and provides structured progress tracking. Based on Anthropic's long-running agent patterns.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# /marathon โ Long-Running Agent Harness
|
|
6
|
+
|
|
7
|
+
$ARGUMENTS
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## When to Use /marathon
|
|
12
|
+
|
|
13
|
+
|Use `/marathon` when...|Use something else when...|
|
|
14
|
+
|:---|:---|
|
|
15
|
+
|A project requires multiple sessions to complete|Quick one-shot task โ `/generate`|
|
|
16
|
+
|You need structured progress tracking across context windows|Single feature addition โ `/enhance`|
|
|
17
|
+
|Building a complex app from a high-level spec|Planning without execution โ `/plan`|
|
|
18
|
+
|Previous agent sessions lost context or declared victory too early|Brainstorming options โ `/brainstorm`|
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Sub-Commands
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
/marathon init [spec] Start a new marathon from a specification
|
|
26
|
+
/marathon continue Resume work: read progress, pick next feature, implement
|
|
27
|
+
/marathon status Show progress dashboard
|
|
28
|
+
/marathon reset Archive current marathon and start fresh
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Phase 1: Initialize (First Session Only)
|
|
34
|
+
|
|
35
|
+
**Trigger:** `/marathon init "Build X"`
|
|
36
|
+
|
|
37
|
+
This phase runs the **Initializer Agent** pattern โ a specialized first session that sets up the foundation for all future sessions.
|
|
38
|
+
|
|
39
|
+
### Steps
|
|
40
|
+
|
|
41
|
+
1. **Parse the specification** โ Read the user's spec carefully
|
|
42
|
+
2. **Decompose into atomic features** โ Generate 30โ200 features depending on project complexity
|
|
43
|
+
- Each feature must be **independently testable**
|
|
44
|
+
- Each must have clear **done criteria** (verification steps)
|
|
45
|
+
- Group by category: `core`, `auth`, `ui`, `data`, `integration`, `polish`
|
|
46
|
+
- All features start with `passes: false`
|
|
47
|
+
3. **Create the marathon state:**
|
|
48
|
+
```bash
|
|
49
|
+
node .agent/scripts/marathon_harness.js init "Build X"
|
|
50
|
+
# Then add features one by one:
|
|
51
|
+
node .agent/scripts/marathon_harness.js add-feature "core" "User can open a new chat" "Navigate to main page" "Click New Chat" "Verify welcome state"
|
|
52
|
+
node .agent/scripts/marathon_harness.js add-feature "core" "User can type and send a message" "Open chat" "Type in input" "Press Enter" "See message appear"
|
|
53
|
+
# ... repeat for all features
|
|
54
|
+
```
|
|
55
|
+
4. **Scaffold the project** โ Create initial files, install dependencies
|
|
56
|
+
5. **Create init.sh** โ Write a bootstrap script that starts the dev environment
|
|
57
|
+
6. **Initial git commit:** `git commit -m "marathon: initial scaffold for [spec]"`
|
|
58
|
+
7. **Human Gate:** User reviews the feature list before proceeding
|
|
59
|
+
|
|
60
|
+
### Feature JSON Format
|
|
61
|
+
|
|
62
|
+
Features are stored in `.agent/history/marathon/feature_list.json` as structured JSON. JSON is used instead of Markdown because agents are less likely to inappropriately modify JSON structures.
|
|
63
|
+
|
|
64
|
+
```json
|
|
65
|
+
{
|
|
66
|
+
"id": 1,
|
|
67
|
+
"category": "core",
|
|
68
|
+
"description": "User can open a new chat and see a welcome screen",
|
|
69
|
+
"steps": [
|
|
70
|
+
"Navigate to main page",
|
|
71
|
+
"Click 'New Chat' button",
|
|
72
|
+
"Verify welcome state renders"
|
|
73
|
+
],
|
|
74
|
+
"passes": false,
|
|
75
|
+
"sessionCompleted": null
|
|
76
|
+
}
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
> [!CAUTION]
|
|
80
|
+
> **Feature descriptions are immutable.** After initialization, agents may ONLY change the `passes` field and `sessionCompleted` timestamp. It is unacceptable to remove, edit, or reorder features โ this could lead to missing or buggy functionality.
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## Phase 2: Get Bearings (Every Session Start)
|
|
85
|
+
|
|
86
|
+
**Trigger:** `/marathon continue`
|
|
87
|
+
|
|
88
|
+
Every new session starts by orienting the agent. This is the **Coding Agent** pattern โ understanding state before making changes.
|
|
89
|
+
|
|
90
|
+
### Steps
|
|
91
|
+
|
|
92
|
+
1. **Read marathon state:**
|
|
93
|
+
```bash
|
|
94
|
+
node .agent/scripts/marathon_harness.js session-start
|
|
95
|
+
```
|
|
96
|
+
This automatically:
|
|
97
|
+
- Reads `progress.json` and shows what was done in previous sessions
|
|
98
|
+
- Reads `git log --oneline -20` for recent commits
|
|
99
|
+
- Shows the next unfinished feature
|
|
100
|
+
- Records the session start time
|
|
101
|
+
|
|
102
|
+
2. **Start the dev environment:**
|
|
103
|
+
```bash
|
|
104
|
+
node .agent/scripts/auto_preview.js start
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
3. **Smoke test basic functionality:**
|
|
108
|
+
- If a web app: navigate to the main page, verify it loads without errors
|
|
109
|
+
- If a CLI tool: run the help command, verify it outputs correctly
|
|
110
|
+
- If an API: hit the health check endpoint
|
|
111
|
+
- If browser MCP tools are available (Puppeteer), use them for visual verification
|
|
112
|
+
|
|
113
|
+
4. **If smoke test fails:** Fix the broken state FIRST before implementing new features. The codebase must be clean before new work begins.
|
|
114
|
+
|
|
115
|
+
5. **Announce bearings:**
|
|
116
|
+
```
|
|
117
|
+
Session N. Progress: 12/47 features (25%).
|
|
118
|
+
Working on: Feature #13 [ui] โ "User can toggle dark mode"
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## Phase 3: Implement (One Feature Per Cycle)
|
|
124
|
+
|
|
125
|
+
Work on exactly **one feature at a time**. This incremental approach prevents the common failure mode of trying to do too much at once.
|
|
126
|
+
|
|
127
|
+
### Steps
|
|
128
|
+
|
|
129
|
+
1. **Impact analysis** โ Identify files that will be affected (per `/enhance` workflow)
|
|
130
|
+
2. **Implement the feature** โ Write code, following Tribunal code quality standards
|
|
131
|
+
3. **Self-verify the feature:**
|
|
132
|
+
- Run the verification steps listed in the feature's `steps` array
|
|
133
|
+
- Test as a human user would (browser for web, CLI for CLI)
|
|
134
|
+
- Run existing tests to ensure no regressions: `npm test` or equivalent
|
|
135
|
+
4. **Mark as passing:**
|
|
136
|
+
```bash
|
|
137
|
+
node .agent/scripts/marathon_harness.js mark <id> pass
|
|
138
|
+
```
|
|
139
|
+
5. **Git commit** with a descriptive message:
|
|
140
|
+
```bash
|
|
141
|
+
git commit -m "marathon: implement feature #13 โ dark mode toggle"
|
|
142
|
+
```
|
|
143
|
+
6. **Check context budget:**
|
|
144
|
+
- If context allows โ return to Phase 2, step 5 (pick next feature)
|
|
145
|
+
- If nearing context limit โ proceed to Phase 4
|
|
146
|
+
|
|
147
|
+
### If a feature cannot be completed
|
|
148
|
+
|
|
149
|
+
If a feature is blocked or too complex for the current session:
|
|
150
|
+
1. Leave it as `passes: false`
|
|
151
|
+
2. Add a log note explaining why:
|
|
152
|
+
```bash
|
|
153
|
+
node .agent/scripts/marathon_harness.js log "Feature #13 blocked: requires OAuth integration not yet set up"
|
|
154
|
+
```
|
|
155
|
+
3. Move to the next feature or proceed to Phase 4
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## Phase 4: Clean Exit (Session End)
|
|
160
|
+
|
|
161
|
+
Every session MUST leave the codebase in a clean, merge-ready state.
|
|
162
|
+
|
|
163
|
+
### Steps
|
|
164
|
+
|
|
165
|
+
1. **Verify clean state:**
|
|
166
|
+
- All code compiles without errors
|
|
167
|
+
- All existing tests pass
|
|
168
|
+
- No half-implemented features left in an intermediate state
|
|
169
|
+
- If something is half-done, either complete it or revert it
|
|
170
|
+
|
|
171
|
+
2. **Record session end:**
|
|
172
|
+
```bash
|
|
173
|
+
node .agent/scripts/marathon_harness.js session-end "Implemented dark mode, user settings page, and notification bell"
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
3. **Final git commit:**
|
|
177
|
+
```bash
|
|
178
|
+
git commit -m "marathon: session N complete, 15/47 features passing"
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
4. **Display status dashboard** โ The session-end command automatically shows progress
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## Marathon Guards
|
|
186
|
+
|
|
187
|
+
```
|
|
188
|
+
โ Never delete or edit feature descriptions โ only change the passes status
|
|
189
|
+
โ Never skip the smoke test at session start โ broken code must be fixed first
|
|
190
|
+
โ Never mark a feature as passing without testing it end-to-end
|
|
191
|
+
โ Never work on more than one feature at a time
|
|
192
|
+
โ Never leave the codebase in a broken state at session end
|
|
193
|
+
โ Never declare the project "done" if any feature has passes: false
|
|
194
|
+
โ Never try to one-shot the entire project โ always work incrementally
|
|
195
|
+
โ Never guess what happened in previous sessions โ read progress.json and git log
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## State Files
|
|
201
|
+
|
|
202
|
+
All marathon state is stored in `.agent/history/marathon/` (preserved on `tk update`):
|
|
203
|
+
|
|
204
|
+
```
|
|
205
|
+
.agent/history/marathon/
|
|
206
|
+
โโโ feature_list.json โ Structured feature backlog (immutable descriptions)
|
|
207
|
+
โโโ progress.json โ Session log + progress notes
|
|
208
|
+
โโโ archive/ โ Previous marathons (after reset)
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
## Script Reference
|
|
214
|
+
|
|
215
|
+
```bash
|
|
216
|
+
# Initialize
|
|
217
|
+
node .agent/scripts/marathon_harness.js init "Build a task management app"
|
|
218
|
+
|
|
219
|
+
# Add features (during init phase)
|
|
220
|
+
node .agent/scripts/marathon_harness.js add-feature "core" "User can create a task" "Click add" "Type title" "Save"
|
|
221
|
+
|
|
222
|
+
# Session lifecycle
|
|
223
|
+
node .agent/scripts/marathon_harness.js session-start
|
|
224
|
+
node .agent/scripts/marathon_harness.js session-end "Completed auth and dashboard"
|
|
225
|
+
|
|
226
|
+
# During implementation
|
|
227
|
+
node .agent/scripts/marathon_harness.js next
|
|
228
|
+
node .agent/scripts/marathon_harness.js mark 5 pass
|
|
229
|
+
node .agent/scripts/marathon_harness.js log "Refactored auth to use JWT"
|
|
230
|
+
|
|
231
|
+
# Status
|
|
232
|
+
node .agent/scripts/marathon_harness.js status
|
|
233
|
+
|
|
234
|
+
# Archive and restart
|
|
235
|
+
node .agent/scripts/marathon_harness.js reset
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
---
|
|
239
|
+
|
|
240
|
+
## Usage Examples
|
|
241
|
+
|
|
242
|
+
```
|
|
243
|
+
/marathon init Build a full-stack clone of claude.ai with chat, settings, and themes
|
|
244
|
+
/marathon continue
|
|
245
|
+
/marathon status
|
|
246
|
+
/marathon reset
|
|
247
|
+
```
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# /super-prompt โ Tokenless Prompt Compiler
|
|
2
|
+
|
|
3
|
+
Converts conversational, fluffy requests into hyper-dense YAML structures that LLMs process perfectly, reducing prompt tokens and drastically improving response accuracy. **Zero API tokens are used during compilation.**
|
|
4
|
+
|
|
5
|
+
## Usage
|
|
6
|
+
|
|
7
|
+
Instead of typing your prompt into the AI chat directly, run the local compiler from your terminal:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
node .agent/scripts/prompt_compiler.js "Hey, could you please build a login page using React and tailwind for me?"
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Expected Output
|
|
14
|
+
|
|
15
|
+
The script strips conversational fillers and outputs a dense YAML block to your terminal instantly:
|
|
16
|
+
|
|
17
|
+
```yaml
|
|
18
|
+
---
|
|
19
|
+
action: build
|
|
20
|
+
target: login page using React and tailwind
|
|
21
|
+
stack: [react, tailwind]
|
|
22
|
+
---
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Next Step
|
|
26
|
+
|
|
27
|
+
Copy the YAML output and paste it into the AI chat. The LLM will use this structured format to generate a highly accurate response while saving massive amounts of context window tokens!
|
package/README.md
CHANGED
|
@@ -1,242 +1,113 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
<picture>
|
|
3
|
-
<img src="./docs/tribunalkit_no_bg.png" alt="TribunalKit โ Code Without Hallucinations" width="480">
|
|
4
|
-
</picture>
|
|
5
|
-
|
|
6
|
-
<br
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
<
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
>
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
>
|
|
82
|
-
>
|
|
83
|
-
>
|
|
84
|
-
>
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
**
|
|
88
|
-
|
|
89
|
-
>
|
|
90
|
-
|
|
91
|
-
<br>
|
|
92
|
-
|
|
93
|
-
## โโโ
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
<
|
|
106
|
-
|
|
107
|
-
<
|
|
108
|
-
|
|
109
|
-
<
|
|
110
|
-
<
|
|
111
|
-
|
|
112
|
-
<
|
|
113
|
-
|
|
114
|
-
</p>
|
|
115
|
-
|
|
116
|
-
<br>
|
|
117
|
-
|
|
118
|
-
## โโโ THE SUPREME COURT (v4.0)
|
|
119
|
-
|
|
120
|
-
*(New in v4)* The Tribunal Kit now features persistent memory so the AI **never makes the same mistake twice** and automatically learns your team's coding style.
|
|
121
|
-
|
|
122
|
-
**1. The Case Law Engine (Never repeat mistakes)**
|
|
123
|
-
If an agent makes a mistake, you can record it as a legal precedent. Before writing any future code, the `precedence-reviewer` checks this database locally to forcefully block the AI from repeating that mistake.
|
|
124
|
-
- `npx tribunal-kit case add` *(Record an AI hallucination)*
|
|
125
|
-
- `npx tribunal-kit case search "query"` *(Search your precedents)*
|
|
126
|
-
|
|
127
|
-
**2. Skill Evolution Forge (Auto-learns your style)**
|
|
128
|
-
You no longer need to write manual rules. The system reads your Git commits, strips out the noise to save tokens, and automatically extracts your project's unique architectural patterns to teach the AI.
|
|
129
|
-
- `npx tribunal-kit learn` *(Run a learning digest on staged files)*
|
|
130
|
-
- `npx tribunal-kit hook` *(Automate learning every time you `git push`)*
|
|
131
|
-
|
|
132
|
-
<br>
|
|
133
|
-
|
|
134
|
-
## โโโ CAPABILITY MATRIX
|
|
135
|
-
|
|
136
|
-
| System Asset | Count | Operational Scope |
|
|
137
|
-
| :--- | :---: | :--- |
|
|
138
|
-
| ๐ค **Agents** | `40` | Specialist personas โ 16 reviewers + 24 domain specialists |
|
|
139
|
-
| ๐ง **Skills** | `90` | Domain modules (Edge Computing, Red Team Tactics, GSAP, Framer Motion, TypeScript Advanced) |
|
|
140
|
-
| โก **Workflows** | `31` | Slash command procedures including `/swarm`, `/tribunal-full`, `/ui-ux-pro-max` |
|
|
141
|
-
| ๐ ๏ธ **Scripts** | `25` | CI/CD, linting, payload dispatching, security scanning, case law, skill evolution |
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
<br>
|
|
145
|
-
|
|
146
|
-
## โโโ COMMAND TERMINAL
|
|
147
|
-
|
|
148
|
-
Expand the accordions to view the operational commands at your disposal.
|
|
149
|
-
|
|
150
|
-
<details open>
|
|
151
|
-
<summary><b>๐ฅ CORE EXECUTION</b></summary>
|
|
152
|
-
<br>
|
|
153
|
-
|
|
154
|
-
| Command | Action |
|
|
155
|
-
| :--- | :--- |
|
|
156
|
-
| <code>/generate</code> | Trigger full Tribunal: Generate โ Audit โ Approve. |
|
|
157
|
-
| <code>/create</code> | Scaffold major features or apps, routed by App Builder. |
|
|
158
|
-
| <code>/enhance</code> | Safely extend existing structures without regression. |
|
|
159
|
-
| <code>/deploy</code> | Force the 3-gate production release sequence. |
|
|
160
|
-
|
|
161
|
-
</details>
|
|
162
|
-
|
|
163
|
-
<details>
|
|
164
|
-
<summary><b>โ๏ธ THE TRIBUNAL GAUNTLET (REVIEWERS)</b></summary>
|
|
165
|
-
<br>
|
|
166
|
-
Unleash parallel reviewers on existing code.
|
|
167
|
-
|
|
168
|
-
| Command | Action |
|
|
169
|
-
| :--- | :--- |
|
|
170
|
-
| <code>/review</code> | Audit code for silent degradation and logic holes. |
|
|
171
|
-
| <code>/tribunal-full</code> | Unleash **ALL 16** reviewers simultaneously. Maximum scrutiny. |
|
|
172
|
-
| <code>/tribunal-backend</code> | Summons <code>[ Logic + Security + Dependency + Types ]</code> |
|
|
173
|
-
| <code>/tribunal-frontend</code> | Summons <code>[ Logic + Security + Frontend + Types ]</code> |
|
|
174
|
-
| <code>/tribunal-database</code> | Summons <code>[ Logic + Security + SQL ]</code> |
|
|
175
|
-
| <code>/tribunal-mobile</code> | Summons <code>[ Logic + Security + Mobile ]</code> |
|
|
176
|
-
|
|
177
|
-
</details>
|
|
178
|
-
|
|
179
|
-
<details>
|
|
180
|
-
<summary><b>๐ง SWARM & ORCHESTRATION</b></summary>
|
|
181
|
-
<br>
|
|
182
|
-
|
|
183
|
-
| Command | Action |
|
|
184
|
-
| :--- | :--- |
|
|
185
|
-
| <code>/swarm</code> | Supervisor breaks goal โ sends to isolated workers โ synthesizes. |
|
|
186
|
-
| <code>/orchestrate</code> | Manual multi-agent sync for complex integrations. |
|
|
187
|
-
| <code>/plan</code> | Architectural mapping before a single line is written. |
|
|
188
|
-
| <code>/ui-ux-pro-max</code>| Triggers peak aesthetic frontend design. |
|
|
189
|
-
|
|
190
|
-
</details>
|
|
191
|
-
|
|
192
|
-
<details>
|
|
193
|
-
<summary><b>โ๏ธ SUPREME COURT / MEMORY</b></summary>
|
|
194
|
-
<br>
|
|
195
|
-
|
|
196
|
-
| Command | Action |
|
|
197
|
-
| :--- | :--- |
|
|
198
|
-
| <code>npx tribunal-kit case add</code> | Record an AI hallucination to ban it forever. |
|
|
199
|
-
| <code>npx tribunal-kit case search</code> | Search your local database of banned code. |
|
|
200
|
-
| <code>npx tribunal-kit learn</code> | Auto-extract project idioms from your git diffs. |
|
|
201
|
-
| <code>npx tribunal-kit hook</code> | Install a git hook to auto-learn the moment you push. |
|
|
202
|
-
|
|
203
|
-
</details>
|
|
204
|
-
|
|
205
|
-
<details>
|
|
206
|
-
<summary><b>๐ง TROUBLESHOOTING & OPS</b></summary>
|
|
207
|
-
<br>
|
|
208
|
-
|
|
209
|
-
| Command | Action |
|
|
210
|
-
| :--- | :--- |
|
|
211
|
-
| <code>/debug</code> | Systematic root-cause investigation. |
|
|
212
|
-
| <code>/preview</code> | Local development server control. |
|
|
213
|
-
| <code>/status</code> | View Tribunal session status. |
|
|
214
|
-
|
|
215
|
-
</details>
|
|
216
|
-
|
|
217
|
-
<br>
|
|
218
|
-
|
|
219
|
-
## โโโ POST-INSTALL TELEMETRY
|
|
220
|
-
|
|
221
|
-
After initialization, utility scripts unlock local ops:
|
|
222
|
-
|
|
223
|
-
```bash
|
|
224
|
-
# 01. Pre-commit audit
|
|
225
|
-
node .agent/scripts/checklist.js .
|
|
226
|
-
|
|
227
|
-
# 02. Pre-deploy full suite verification
|
|
228
|
-
node .agent/scripts/verify_all.js
|
|
229
|
-
|
|
230
|
-
# 03. Start local development environment
|
|
231
|
-
node .agent/scripts/auto_preview.js start
|
|
232
|
-
```
|
|
233
|
-
|
|
234
|
-
<br>
|
|
235
|
-
|
|
236
|
-
<div align="center">
|
|
237
|
-
<br>
|
|
238
|
-
<img src="https://img.shields.io/badge/Status-Active_&_Secured-00e5ff?style=for-the-badge" alt="Status" />
|
|
239
|
-
<br><br>
|
|
240
|
-
<i>"Never guess database column names. Error handling on every async function. Evidence-based closeouts. Welcome to the Tribunal."</i><br>
|
|
241
|
-
<sub><b>MIT Licensed</b> โข Hand-forged for high-performance agentic engineering.</sub>
|
|
242
|
-
</div>
|
|
1
|
+
<div align="center">
|
|
2
|
+
<picture>
|
|
3
|
+
<img src="./docs/tribunalkit_no_bg.png" alt="TribunalKit โ Code Without Hallucinations" width="480">
|
|
4
|
+
</picture>
|
|
5
|
+
|
|
6
|
+
<br>
|
|
7
|
+
|
|
8
|
+
<h1>TRIBUNAL KIT</h1>
|
|
9
|
+
<p><b>Anti-Hallucination Agent Architecture โข Long-Running Autonomy โข Pipeline Scrutiny</b></p>
|
|
10
|
+
|
|
11
|
+
[](https://www.npmjs.com/package/tribunal-kit)
|
|
12
|
+
[](LICENSE)
|
|
13
|
+
[](CHANGELOG.md)
|
|
14
|
+
</div>
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
> [!IMPORTANT]
|
|
19
|
+
> **AI GENERATES CODE. TRIBUNAL ENSURES IT WORKS.**
|
|
20
|
+
> A zero-bloat `.agent/` intelligence payload that upgrades your IDE with **41 specialist agents**, **31 workflows**, and a **16-reviewer Tribunal pipeline**. Zero hallucinations. Absolute execution certainty.
|
|
21
|
+
|
|
22
|
+
## โโโ QUICK START
|
|
23
|
+
|
|
24
|
+
Drop Tribunal into any existing project to instantly weaponize your IDE.
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
# Pull the intelligence payload into your project directory
|
|
28
|
+
npx tribunal-kit init
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
> [!NOTE]
|
|
32
|
+
> `init` automatically generates bridge rules for **Cursor**, **Windsurf**, **Gemini**, **Copilot**, and **Claude**. No configuration required.
|
|
33
|
+
|
|
34
|
+
<br>
|
|
35
|
+
|
|
36
|
+
## โโโ THE MARATHON HARNESS (v4.4.4)
|
|
37
|
+
|
|
38
|
+
The v4.4 update introduces the **Marathon Harness**โan engine designed to keep autonomous agents on track during long-running, multi-session projects without looping or losing context.
|
|
39
|
+
|
|
40
|
+
### โ๏ธ Directed Acyclic Graph (DAG) Support
|
|
41
|
+
Cascade failures are obsolete. Features can now be declared with dependencies (`--deps=1,2`). If a database schema task fails, the API route task is automatically flagged as **Deadlocked** and bypassed until the root issue is resolved.
|
|
42
|
+
|
|
43
|
+
### ๐ง Failure Context & Attempt Tracking
|
|
44
|
+
Agents no longer blindly retry failed approaches. When a feature fails, the reason and attempt count are permanently logged into the state matrix. The next agent to attempt the feature receives the exact failure history to course-correct immediately.
|
|
45
|
+
|
|
46
|
+
### ๐ฎ Memory Distillation
|
|
47
|
+
Context windows dilute over time. The new `distill` command allows agents to forge crucial architectural decisions into a permanent `distilled_context.md` memory matrix, bridging the amnesia gap between long work sessions.
|
|
48
|
+
|
|
49
|
+
<br>
|
|
50
|
+
|
|
51
|
+
## โโโ THE PIPELINE // EVIDENCE-BASED CLOSEOUT
|
|
52
|
+
|
|
53
|
+
Code generation is solved. **Code correctness is the frontier.**
|
|
54
|
+
|
|
55
|
+
```mermaid
|
|
56
|
+
graph TD
|
|
57
|
+
A[User Request] -->|Intent Parsed| B(Context Broker)
|
|
58
|
+
B --> C{Inner-Loop Validator}
|
|
59
|
+
|
|
60
|
+
C -->|Syntax & Secrets Check| D[Parallel Tribunal Review]
|
|
61
|
+
C -.->|Failed| E[Maker Auto-Correction]
|
|
62
|
+
E -.-> C
|
|
63
|
+
|
|
64
|
+
D -->|16 Domain Reviewers| F[Human Gate]
|
|
65
|
+
F -->|Approved| G((Committed to Disk))
|
|
66
|
+
|
|
67
|
+
classDef default fill:#1a1a1a,stroke:#333,stroke-width:2px,color:#fff;
|
|
68
|
+
classDef critical fill:#ff1637,stroke:#fff,stroke-width:2px,color:#fff;
|
|
69
|
+
classDef success fill:#00e5ff,stroke:#fff,stroke-width:2px,color:#1a1a1a;
|
|
70
|
+
|
|
71
|
+
class D critical;
|
|
72
|
+
class G success;
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
<br>
|
|
76
|
+
|
|
77
|
+
## โโโ THE SUPREME COURT (CASE LAW ENGINE)
|
|
78
|
+
|
|
79
|
+
The Tribunal Kit features persistent memory. The AI **never makes the same mistake twice** and auto-learns your engineering culture.
|
|
80
|
+
|
|
81
|
+
> [!WARNING]
|
|
82
|
+
> **1. The Case Law Engine**
|
|
83
|
+
> Record mistakes as legal precedent. The `precedence-reviewer` checks this database locally to forcefully block the AI from repeating banned patterns.
|
|
84
|
+
> - `npx tribunal-kit case add` *(Record an AI hallucination)*
|
|
85
|
+
|
|
86
|
+
> [!TIP]
|
|
87
|
+
> **2. Skill Evolution Forge**
|
|
88
|
+
> Stop writing manual rules. The system reads your Git diffs, strips token bloat, and auto-extracts your project's architectural idioms.
|
|
89
|
+
> - `npx tribunal-kit learn` *(Digest staged files)*
|
|
90
|
+
|
|
91
|
+
<br>
|
|
92
|
+
|
|
93
|
+
## โโโ COMMAND ARSENAL
|
|
94
|
+
|
|
95
|
+
| Slash Command | Operational Scope |
|
|
96
|
+
| :--- | :--- |
|
|
97
|
+
| `/generate` | Full Tribunal sequence: Generate โ Audit โ Human Gate. |
|
|
98
|
+
| `/create` | Scaffold major applications via App Builder routing. |
|
|
99
|
+
| `/enhance` | Safely extend existing codebases with zero regression. |
|
|
100
|
+
| `/swarm` | Fan-out orchestrator. Dispatch isolated workers, synthesize output. |
|
|
101
|
+
| `/tribunal-full` | Unleash **ALL 16** domain reviewers simultaneously for maximum scrutiny. |
|
|
102
|
+
| `/debug` | Systematic 4-phase root-cause investigation. No guessing. |
|
|
103
|
+
| `/ui-ux-pro-max` | Advanced visual aesthetic engine. No generic AI slop. |
|
|
104
|
+
|
|
105
|
+
<br>
|
|
106
|
+
|
|
107
|
+
<div align="center">
|
|
108
|
+
<br>
|
|
109
|
+
<img src="https://img.shields.io/badge/Status-Active_&_Secured-00e5ff?style=for-the-badge" alt="Status" />
|
|
110
|
+
<br><br>
|
|
111
|
+
<i>"Never guess database column names. Error handling on every async function. Evidence-based closeouts. Welcome to the Tribunal."</i><br>
|
|
112
|
+
<sub><b>MIT Licensed</b> โข Engineered for maximum autonomy and precision.</sub>
|
|
113
|
+
</div>
|