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.
Files changed (108) hide show
  1. package/.agent/scripts/marathon_harness.js +896 -0
  2. package/.agent/scripts/prompt_compiler.js +87 -0
  3. package/.agent/skills/agent-organizer/SKILL.md +42 -0
  4. package/.agent/skills/agentic-patterns/SKILL.md +42 -0
  5. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +42 -0
  6. package/.agent/skills/api-patterns/SKILL.md +42 -0
  7. package/.agent/skills/api-security-auditor/SKILL.md +42 -0
  8. package/.agent/skills/app-builder/SKILL.md +42 -0
  9. package/.agent/skills/appflow-wireframe/SKILL.md +42 -0
  10. package/.agent/skills/architecture/SKILL.md +42 -0
  11. package/.agent/skills/authentication-best-practices/SKILL.md +42 -0
  12. package/.agent/skills/backend-security-expert/SKILL.md +122 -0
  13. package/.agent/skills/bash-linux/SKILL.md +42 -0
  14. package/.agent/skills/behavioral-modes/SKILL.md +42 -0
  15. package/.agent/skills/brainstorming/SKILL.md +42 -0
  16. package/.agent/skills/building-native-ui/SKILL.md +42 -0
  17. package/.agent/skills/clean-code/SKILL.md +42 -0
  18. package/.agent/skills/code-review-checklist/SKILL.md +42 -0
  19. package/.agent/skills/config-validator/SKILL.md +42 -0
  20. package/.agent/skills/csharp-developer/SKILL.md +42 -0
  21. package/.agent/skills/data-validation-schemas/SKILL.md +42 -0
  22. package/.agent/skills/database-design/SKILL.md +42 -0
  23. package/.agent/skills/deployment-procedures/SKILL.md +42 -0
  24. package/.agent/skills/devops-engineer/SKILL.md +42 -0
  25. package/.agent/skills/devops-incident-responder/SKILL.md +42 -0
  26. package/.agent/skills/documentation-templates/SKILL.md +42 -0
  27. package/.agent/skills/edge-computing/SKILL.md +42 -0
  28. package/.agent/skills/error-resilience/SKILL.md +42 -0
  29. package/.agent/skills/extract-design-system/SKILL.md +42 -0
  30. package/.agent/skills/framer-motion-expert/SKILL.md +42 -0
  31. package/.agent/skills/frontend-design/SKILL.md +42 -0
  32. package/.agent/skills/frontend-security-expert/SKILL.md +123 -0
  33. package/.agent/skills/game-design-expert/SKILL.md +42 -0
  34. package/.agent/skills/game-engineering-expert/SKILL.md +42 -0
  35. package/.agent/skills/geo-fundamentals/SKILL.md +42 -0
  36. package/.agent/skills/github-operations/SKILL.md +42 -0
  37. package/.agent/skills/gsap-core/SKILL.md +42 -0
  38. package/.agent/skills/gsap-frameworks/SKILL.md +42 -0
  39. package/.agent/skills/gsap-performance/SKILL.md +42 -0
  40. package/.agent/skills/gsap-plugins/SKILL.md +42 -0
  41. package/.agent/skills/gsap-react/SKILL.md +42 -0
  42. package/.agent/skills/gsap-scrolltrigger/SKILL.md +42 -0
  43. package/.agent/skills/gsap-timeline/SKILL.md +42 -0
  44. package/.agent/skills/gsap-utils/SKILL.md +42 -0
  45. package/.agent/skills/i18n-localization/SKILL.md +42 -0
  46. package/.agent/skills/intelligent-routing/SKILL.md +42 -0
  47. package/.agent/skills/knowledge-graph/SKILL.md +42 -0
  48. package/.agent/skills/lint-and-validate/SKILL.md +42 -0
  49. package/.agent/skills/llm-engineering/SKILL.md +42 -0
  50. package/.agent/skills/local-first/SKILL.md +42 -0
  51. package/.agent/skills/mcp-builder/SKILL.md +42 -0
  52. package/.agent/skills/mobile-design/SKILL.md +42 -0
  53. package/.agent/skills/monorepo-management/SKILL.md +42 -0
  54. package/.agent/skills/motion-engineering/SKILL.md +42 -0
  55. package/.agent/skills/nextjs-react-expert/SKILL.md +42 -0
  56. package/.agent/skills/nodejs-best-practices/SKILL.md +42 -0
  57. package/.agent/skills/observability/SKILL.md +42 -0
  58. package/.agent/skills/parallel-agents/SKILL.md +42 -0
  59. package/.agent/skills/performance-profiling/SKILL.md +42 -0
  60. package/.agent/skills/plan-writing/SKILL.md +42 -0
  61. package/.agent/skills/platform-engineer/SKILL.md +42 -0
  62. package/.agent/skills/playwright-best-practices/SKILL.md +42 -0
  63. package/.agent/skills/powershell-windows/SKILL.md +42 -0
  64. package/.agent/skills/project-idioms/SKILL.md +42 -0
  65. package/.agent/skills/python-patterns/SKILL.md +42 -0
  66. package/.agent/skills/python-pro/SKILL.md +42 -0
  67. package/.agent/skills/react-specialist/SKILL.md +42 -0
  68. package/.agent/skills/readme-builder/SKILL.md +42 -0
  69. package/.agent/skills/realtime-patterns/SKILL.md +42 -0
  70. package/.agent/skills/red-team-tactics/SKILL.md +42 -0
  71. package/.agent/skills/rust-pro/SKILL.md +42 -0
  72. package/.agent/skills/seo-fundamentals/SKILL.md +42 -0
  73. package/.agent/skills/server-management/SKILL.md +42 -0
  74. package/.agent/skills/shadcn-ui-expert/SKILL.md +42 -0
  75. package/.agent/skills/skill-creator/SKILL.md +42 -0
  76. package/.agent/skills/sql-pro/SKILL.md +42 -0
  77. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +42 -0
  78. package/.agent/skills/swiftui-expert/SKILL.md +42 -0
  79. package/.agent/skills/systematic-debugging/SKILL.md +42 -0
  80. package/.agent/skills/tailwind-patterns/SKILL.md +42 -0
  81. package/.agent/skills/tdd-workflow/SKILL.md +42 -0
  82. package/.agent/skills/test-result-analyzer/SKILL.md +42 -0
  83. package/.agent/skills/testing-patterns/SKILL.md +42 -0
  84. package/.agent/skills/trend-researcher/SKILL.md +42 -0
  85. package/.agent/skills/typescript-advanced/SKILL.md +42 -0
  86. package/.agent/skills/ui-ux-pro-max/SKILL.md +42 -0
  87. package/.agent/skills/ui-ux-researcher/SKILL.md +42 -0
  88. package/.agent/skills/vue-expert/SKILL.md +42 -0
  89. package/.agent/skills/vulnerability-scanner/SKILL.md +42 -0
  90. package/.agent/skills/web-accessibility-auditor/SKILL.md +42 -0
  91. package/.agent/skills/web-design-guidelines/SKILL.md +42 -0
  92. package/.agent/skills/webapp-testing/SKILL.md +42 -0
  93. package/.agent/skills/whimsy-injector/SKILL.md +42 -0
  94. package/.agent/skills/workflow-optimizer/SKILL.md +42 -0
  95. package/.agent/workflows/marathon.md +247 -0
  96. package/.agent/workflows/super-prompt.md +27 -0
  97. package/README.md +113 -242
  98. package/bin/tribunal-kit.js +49 -3
  99. package/package.json +3 -2
  100. package/.agent/scripts/append_flow.js +0 -72
  101. package/.agent/scripts/colors.js +0 -11
  102. package/.agent/scripts/compress_skills.js +0 -141
  103. package/.agent/scripts/consolidate_skills.js +0 -149
  104. package/.agent/scripts/deep_compress.js +0 -150
  105. package/.agent/scripts/patch_skills_meta.js +0 -156
  106. package/.agent/scripts/patch_skills_output.js +0 -244
  107. package/.agent/scripts/strip_tribunal.js +0 -47
  108. 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><br>
7
-
8
- [![NPM](https://img.shields.io/npm/v/tribunal-kit?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/tribunal-kit)
9
- [![License](https://img.shields.io/badge/License-MIT-8b5cf6?style=for-the-badge)](LICENSE)
10
- [![Version](https://img.shields.io/badge/Version-4.3.1_Supreme_Court-black?style=for-the-badge)](CHANGELOG.md)
11
- </div>
12
-
13
-
14
- <br><br>
15
-
16
- > ๐Ÿšจ **AI GENERATES CODE. TRIBUNAL ENSURES IT WORKS.**
17
- > A plug-in `.agent/` intelligence payload that upgrades your IDE with **41 specialist agents**, **31 slash commands**, **91 hardened skills**, and a **16-reviewer Tribunal pipeline** โ€” zero hallucinations, zero configuration.
18
-
19
- ---
20
-
21
- <br>
22
-
23
- ## โ–“โ–’โ–‘ INITIATION SEQUENCE
24
-
25
- Drop Tribunal into any project. Global or local.
26
-
27
- ```bash
28
- # Pull the intelligence payload into your project
29
- npx tribunal-kit init
30
- ```
31
- *(Installs the `.agent/` architecture directly. No bloat. Pure capability.)*
32
-
33
- <details>
34
- <summary><b>๐Ÿ“บ Quick Demo โ€” What happens when you run it</b></summary>
35
- <br>
36
-
37
- ```
38
- $ npx tribunal-kit init
39
-
40
- โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—
41
- โ•šโ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘
42
- โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘
43
- โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘
44
- โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘ โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—
45
- โ•šโ•โ• โ•šโ•โ• โ•šโ•โ•โ•šโ•โ•โ•šโ•โ•โ•โ•โ•โ• โ•šโ•โ•โ•โ•โ•โ• โ•šโ•โ• โ•šโ•โ•โ•โ•โ•šโ•โ• โ•šโ•โ•โ•šโ•โ•โ•โ•โ•โ•โ•
46
-
47
- โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—
48
- โ•‘ Anti-Hallucination Agent System โ•‘
49
- โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•
50
-
51
- โœ” Installed โ†’ .agent/
52
-
53
- โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—
54
- โ•‘ ๐Ÿค– Agents 41 installed โ•‘
55
- โ•‘ โšก Workflows 32 installed โ•‘
56
- โ•‘ ๐Ÿง  Skills 91 installed โ•‘
57
- โ•‘ ๐Ÿ”ง Scripts 27 installed โ•‘
58
- โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•
59
-
60
- โœ” 700+ files installed. 16 parallel Tribunal reviewers armed.
61
-
62
- $ npx tribunal-kit status
63
-
64
- โœ” Installed at .agent/
65
- ๐Ÿค– agents 40 files
66
- โšก workflows 31 files
67
- ๐Ÿง  skills 90 files
68
- ๐Ÿ”ง scripts 27 files
69
- ```
70
-
71
- > ๐Ÿ’ก **Lighter install?** Use `npx tribunal-kit init --minimal` for just 13 core agents + 15 essential skills.
72
-
73
- </details>
74
-
75
- > โœ… **IDE Auto-Detection:** `init` automatically generates bridge files for every major AI coding IDE:
76
- >
77
- > | IDE | Bridge File Generated |
78
- > | :--- | :--- |
79
- > | **Cursor** | `.cursorrules` |
80
- > | **Windsurf** | `.windsurfrules` |
81
- > | **Gemini / Antigravity** | `.gemini/settings.json` + `.gemini/GEMINI.md` |
82
- > | **GitHub Copilot** | `.github/copilot-instructions.md` |
83
- > | **Claude** | `.claude/CLAUDE.md` |
84
- >
85
- > Bridge files are never overwritten on re-init โ€” your customizations are safe.
86
-
87
- **Prerequisites:** Node.js โ‰ฅ 18
88
-
89
- > ๐Ÿ’ก **Shorthand alias:** You can use `tk` instead of `tribunal-kit` for all commands (e.g., `tk init`, `tk status`).
90
-
91
- <br>
92
-
93
- ## โ–“โ–’โ–‘ THE PIPELINE // HOW IT WORKS
94
-
95
- **Code generation is solved. Code correctness is the frontier.** We enforce a strict **Evidence-Based Closeout**.
96
-
97
- ```diff
98
- - AI Generates -> Commits to Disk -> You Find Bugs Later
99
- + AI Generates -> Parallel Tribunal Review -> Human Gate -> Commits to Disk
100
- ```
101
-
102
- ### ๐ŸŽฏ Auto-Routing Intelligence
103
- No manual tagging required. The system self-organizes.
104
-
105
- <p>
106
- <kbd>User</kbd> "Add JWT authentication" <br>
107
- <kbd>System</kbd> <code>๐Ÿค– Applying @security-auditor + @backend-specialist...</code> <br><br>
108
-
109
- <kbd>User</kbd> "Fix the dark mode button" <br>
110
- <kbd>System</kbd> <code>๐Ÿค– Applying @ui-ux-pro-max + @frontend-specialist...</code> <br><br>
111
-
112
- <kbd>User</kbd> "/swarm build a API" <br>
113
- <kbd>System</kbd> <code>๐Ÿค– supervisor-agent โ†’ Dispatching 3 Workers...</code>
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
+ [![NPM](https://img.shields.io/npm/v/tribunal-kit?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/tribunal-kit)
12
+ [![License](https://img.shields.io/badge/License-MIT-8b5cf6?style=for-the-badge)](LICENSE)
13
+ [![Version](https://img.shields.io/badge/Version-4.4.4_Marathon-black?style=for-the-badge)](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>