tribunal-kit 8.0.0 → 9.0.1

package/skills/app-builder/templates/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: templates
+description: Project scaffolding templates for new applications. Use when creating new projects from scratch. Contains 12 templates for various tech stacks.
+allowed-tools: Read, Glob, Grep
+---
+
+# Project Templates
+
+---
+
+## 🎯 Selective Reading Rule
+
+**Read ONLY the template matching user's project type!**
+
+| Template                                             | Tech Stack          | When to Use        |
+| ---------------------------------------------------- | ------------------- | ------------------ |
+| [nextjs-fullstack](nextjs-fullstack/TEMPLATE.md)     | Next.js + Prisma    | Full-stack web app |
+| [nextjs-saas](nextjs-saas/TEMPLATE.md)               | Next.js + Stripe    | SaaS product       |
+| [nextjs-static](nextjs-static/TEMPLATE.md)           | Next.js + Framer    | Landing page       |
+| [express-api](express-api/TEMPLATE.md)               | Express + JWT       | REST API           |
+| [python-fastapi](python-fastapi/TEMPLATE.md)         | FastAPI             | Python API         |
+| [react-native-app](react-native-app/TEMPLATE.md)     | Expo + Zustand      | Mobile app         |
+| [flutter-app](flutter-app/TEMPLATE.md)               | Flutter + Riverpod  | Cross-platform     |
+| [electron-desktop](electron-desktop/TEMPLATE.md)     | Electron + React    | Desktop app        |
+| [chrome-extension](chrome-extension/TEMPLATE.md)     | Chrome MV3          | Browser extension  |
+| [cli-tool](cli-tool/TEMPLATE.md)                     | Node.js + Commander | CLI app            |
+| [monorepo-turborepo](monorepo-turborepo/TEMPLATE.md) | Turborepo + pnpm    | Monorepo           |
+| [astro-static](astro-static/TEMPLATE.md)             | Astro + MDX         | Blog / Docs        |
+
+---
+
+## Usage
+
+1. User says "create [type] app"
+2. Match to appropriate template
+3. Read ONLY that template's TEMPLATE.md
+4. Follow its tech stack and structure
+
+---
+
+## 🚨 LLM Trap Table
+
+| Pattern                  | What AI Does Wrong | What Is Actually Correct |
+| :----------------------- | :----------------- | :----------------------- |
+| [domain-specific trap 1] | [hallucination]    | [correct behavior]       |
+| [domain-specific trap 2] | [hallucination]    | [correct behavior]       |
+| [domain-specific trap 3] | [hallucination]    | [correct behavior]       |
+
+---
+
+## ✅ Pre-Flight Self-Audit
+
+Before producing any output, verify:
+`✅ Did I read the actual files before making claims about them?
+✅ Did I verify all method names against official documentation?
+✅ Did I add // VERIFY: on any uncertain API calls?
+✅ Are all imports from packages that actually exist in package.json?
+✅ Did I test my logic with edge cases (null, empty, 0, max)?
+✅ Did I avoid generating code for more than one module at a time?
+✅ Am I working from evidence, not assumption?`
+
+---
+
+## 🔁 VBC Protocol (Verify → Build → Confirm)
+
+`VERIFY:  Read the actual codebase before writing anything
+BUILD:   Generate the smallest meaningful unit of code
+CONFIRM: Verify the output is correct before presenting`
+
+---
+
+## 🚨 LLM Trap Table
+
+| Pattern                  | What AI Does Wrong | What Is Actually Correct |
+| :----------------------- | :----------------- | :----------------------- |
+| [domain-specific trap 1] | [hallucination]    | [correct behavior]       |
+| [domain-specific trap 2] | [hallucination]    | [correct behavior]       |
+| [domain-specific trap 3] | [hallucination]    | [correct behavior]       |
+
+---
+
+## ✅ Pre-Flight Self-Audit
+
+Before producing any output, verify:
+`✅ Did I read the actual files before making claims about them?
+✅ Did I verify all method names against official documentation?
+✅ Did I add // VERIFY: on any uncertain API calls?
+✅ Are all imports from packages that actually exist in package.json?
+✅ Did I test my logic with edge cases (null, empty, 0, max)?
+✅ Did I avoid generating code for more than one module at a time?
+✅ Am I working from evidence, not assumption?`
+
+---
+
+## 🔁 VBC Protocol (Verify → Build → Confirm)
+
+`VERIFY:  Read the actual codebase before writing anything
+BUILD:   Generate the smallest meaningful unit of code
+CONFIRM: Verify the output is correct before presenting`
+
+## Pre-Flight Checklist
+
+- [ ] Have I reviewed the user's specific constraints and requests?
+- [ ] Have I checked the environment for relevant existing implementations?
+
+## VBC Protocol (Verification-Before-Completion)
+
+You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.

package/skills/app-builder/templates/astro-static/TEMPLATE.md

@@ -0,0 +1,76 @@
+---
+name: astro-static
+description: Astro static site template principles. Content-focused websites, blogs, documentation.
+---
+
+# Astro Static Site Template
+
+## Tech Stack
+
+| Component    | Technology                |
+| ------------ | ------------------------- |
+| Framework    | Astro 4.x                 |
+| Content      | MDX + Content Collections |
+| Styling      | Tailwind CSS              |
+| Integrations | Sitemap, RSS, SEO         |
+| Output       | Static/SSG                |
+
+---
+
+## Directory Structure
+
+```
+project-name/
+├── src/
+│   ├── components/      # .astro components
+│   ├── content/         # MDX content
+│   │   ├── blog/
+│   │   └── config.ts    # Collection schemas
+│   ├── layouts/         # Page layouts
+│   ├── pages/           # File-based routing
+│   └── styles/
+├── public/              # Static assets
+├── astro.config.mjs
+└── package.json
+```
+
+---
+
+## Key Concepts
+
+| Concept              | Description                         |
+| -------------------- | ----------------------------------- |
+| Content Collections  | Type-safe content with Zod schemas  |
+| Islands Architecture | Partial hydration for interactivity |
+| Zero JS by default   | Static HTML unless needed           |
+| MDX Support          | Markdown with components            |
+
+---
+
+## Setup Steps
+
+1. `npm create astro@latest {{name}}`
+2. Add integrations: `npx astro add mdx tailwind sitemap`
+3. Configure `astro.config.mjs`
+4. Create content collections
+5. `npm run dev`
+
+---
+
+## Deployment
+
+| Platform         | Method                |
+| ---------------- | --------------------- |
+| Vercel           | Auto-detected         |
+| Netlify          | Auto-detected         |
+| Cloudflare Pages | Auto-detected         |
+| GitHub Pages     | Build + deploy action |
+
+---
+
+## Best Practices
+
+- Use Content Collections for type safety
+- Leverage static generation
+- Add islands only where needed
+- Optimize images with Astro Image

package/skills/app-builder/templates/chrome-extension/TEMPLATE.md

@@ -0,0 +1,92 @@
+---
+name: chrome-extension
+description: Chrome Extension template principles. Manifest V3, React, TypeScript.
+---
+
+# Chrome Extension Template
+
+## Tech Stack
+
+| Component | Technology         |
+| --------- | ------------------ |
+| Manifest  | V3                 |
+| UI        | React 19           |
+| Language  | TypeScript         |
+| Styling   | Tailwind CSS       |
+| Bundler   | Vite               |
+| Storage   | Chrome Storage API |
+
+---
+
+## Directory Structure
+
+```
+project-name/
+├── src/
+│   ├── popup/           # Extension popup
+│   ├── options/         # Options page
+│   ├── background/      # Service worker
+│   ├── content/         # Content scripts
+│   ├── components/
+│   ├── hooks/
+│   └── lib/
+│       ├── storage.ts   # Chrome storage helpers
+│       └── messaging.ts # Message passing
+├── public/
+│   ├── icons/
+│   └── manifest.json
+└── package.json
+```
+
+---
+
+## Manifest V3 Concepts
+
+| Component       | Purpose               |
+| --------------- | --------------------- |
+| Service Worker  | Background processing |
+| Content Scripts | Page injection        |
+| Popup           | User interface        |
+| Options Page    | Settings              |
+
+---
+
+## Permissions
+
+| Permission       | Use                |
+| ---------------- | ------------------ |
+| storage          | Save user data     |
+| activeTab        | Current tab access |
+| scripting        | Inject scripts     |
+| host_permissions | Site access        |
+
+---
+
+## Setup Steps
+
+1. `npm create vite {{name}} -- --template react-ts`
+2. Add Chrome types: `npm install -D @types/chrome`
+3. Configure Vite for multi-entry
+4. Create manifest.json
+5. `npm run dev` (watch mode)
+6. Load in Chrome: `chrome://extensions` → Load unpacked
+
+---
+
+## Development Tips
+
+| Task             | Method                           |
+| ---------------- | -------------------------------- |
+| Debug Popup      | Right-click icon → Inspect       |
+| Debug Background | Extensions page → Service worker |
+| Debug Content    | DevTools console on page         |
+| Hot Reload       | `npm run dev` with watch         |
+
+---
+
+## Best Practices
+
+- Use type-safe messaging
+- Wrap Chrome APIs in promises
+- Minimize permissions
+- Handle offline gracefully

package/skills/app-builder/templates/cli-tool/TEMPLATE.md

@@ -0,0 +1,88 @@
+---
+name: cli-tool
+description: Node.js CLI tool template principles. Commander.js, interactive prompts.
+---
+
+# CLI Tool Template
+
+## Tech Stack
+
+| Component     | Technology   |
+| ------------- | ------------ |
+| Runtime       | Node.js 20+  |
+| Language      | TypeScript   |
+| CLI Framework | Commander.js |
+| Prompts       | Inquirer.js  |
+| Output        | chalk + ora  |
+| Config        | cosmiconfig  |
+
+---
+
+## Directory Structure
+
+```
+project-name/
+├── src/
+│   ├── index.ts         # Entry point
+│   ├── cli.ts           # CLI setup
+│   ├── commands/        # Command handlers
+│   ├── lib/
+│   │   ├── config.ts    # Config loader
+│   │   └── logger.ts    # Styled output
+│   └── types/
+├── bin/
+│   └── cli.js           # Executable
+└── package.json
+```
+
+---
+
+## CLI Design Principles
+
+| Principle       | Description           |
+| --------------- | --------------------- |
+| Subcommands     | Group related actions |
+| Options         | Flags with defaults   |
+| Interactive     | Prompts when needed   |
+| Non-interactive | Support --yes flags   |
+
+---
+
+## Key Components
+
+| Component   | Purpose               |
+| ----------- | --------------------- |
+| Commander   | Command parsing       |
+| Inquirer    | Interactive prompts   |
+| Chalk       | Colored output        |
+| Ora         | Spinners/loading      |
+| Cosmiconfig | Config file discovery |
+
+---
+
+## Setup Steps
+
+1. Create project directory
+2. `npm init -y`
+3. Install deps: `npm install commander @inquirer/prompts chalk ora cosmiconfig`
+4. Configure bin in package.json
+5. `npm link` for local testing
+
+---
+
+## Publishing
+
+```bash
+npm login
+npm publish
+```
+
+---
+
+## Best Practices
+
+- Provide helpful error messages
+- Support both interactive and non-interactive modes
+- Use consistent output styling
+- Validate inputs with Zod
+- Exit with proper codes (0 success, 1 error)

package/skills/app-builder/templates/electron-desktop/TEMPLATE.md

@@ -0,0 +1,88 @@
+---
+name: electron-desktop
+description: Electron desktop app template principles. Cross-platform, React, TypeScript.
+---
+
+# Electron Desktop App Template
+
+## Tech Stack
+
+| Component | Technology              |
+| --------- | ----------------------- |
+| Framework | Electron 28+            |
+| UI        | React 19                |
+| Language  | TypeScript              |
+| Styling   | Tailwind CSS            |
+| Bundler   | Vite + electron-builder |
+| IPC       | Type-safe communication |
+
+---
+
+## Directory Structure
+
+```
+project-name/
+├── electron/
+│   ├── main.ts          # Main process
+│   ├── preload.ts       # Preload script
+│   └── ipc/             # IPC handlers
+├── src/
+│   ├── App.tsx
+│   ├── components/
+│   │   ├── TitleBar.tsx # Custom title bar
+│   │   └── ...
+│   └── hooks/
+├── public/
+└── package.json
+```
+
+---
+
+## Process Model
+
+| Process  | Role                      |
+| -------- | ------------------------- |
+| Main     | Node.js, system access    |
+| Renderer | Chromium, React UI        |
+| Preload  | Bridge, context isolation |
+
+---
+
+## Key Concepts
+
+| Concept                | Purpose               |
+| ---------------------- | --------------------- |
+| contextBridge          | Safe API exposure     |
+| ipcMain/ipcRenderer    | Process communication |
+| nodeIntegration: false | Security              |
+| contextIsolation: true | Security              |
+
+---
+
+## Setup Steps
+
+1. `npm create vite {{name}} -- --template react-ts`
+2. Install: `npm install -D electron electron-builder vite-plugin-electron`
+3. Create electron/ directory
+4. Configure main process
+5. `npm run electron:dev`
+
+---
+
+## Build Targets
+
+| Platform | Output         |
+| -------- | -------------- |
+| Windows  | NSIS, Portable |
+| macOS    | DMG, ZIP       |
+| Linux    | AppImage, DEB  |
+
+---
+
+## Best Practices
+
+- Use preload script for main/renderer bridge
+- Type-safe IPC with typed handlers
+- Custom title bar for native feel
+- Handle window state (maximize, minimize)
+- Auto-updates with electron-updater

package/skills/app-builder/templates/express-api/TEMPLATE.md

@@ -0,0 +1,83 @@
+---
+name: express-api
+description: Express.js REST API template principles. TypeScript, Prisma, JWT.
+---
+
+# Express.js API Template
+
+## Tech Stack
+
+| Component  | Technology          |
+| ---------- | ------------------- |
+| Runtime    | Node.js 20+         |
+| Framework  | Express.js          |
+| Language   | TypeScript          |
+| Database   | PostgreSQL + Prisma |
+| Validation | Zod                 |
+| Auth       | JWT + bcrypt        |
+
+---
+
+## Directory Structure
+
+```
+project-name/
+├── prisma/
+│   └── schema.prisma
+├── src/
+│   ├── app.ts           # Express setup
+│   ├── config/          # Environment
+│   ├── routes/          # Route handlers
+│   ├── controllers/     # Business logic
+│   ├── services/        # Data access
+│   ├── middleware/
+│   │   ├── auth.ts      # JWT verify
+│   │   ├── error.ts     # Error handler
+│   │   └── validate.ts  # Zod validation
+│   ├── schemas/         # Zod schemas
+│   └── utils/
+└── package.json
+```
+
+---
+
+## Middleware Stack
+
+| Order | Middleware        |
+| ----- | ----------------- |
+| 1     | helmet (security) |
+| 2     | cors              |
+| 3     | morgan (logging)  |
+| 4     | body parsing      |
+| 5     | routes            |
+| 6     | error handler     |
+
+---
+
+## API Response Format
+
+| Type    | Structure                              |
+| ------- | -------------------------------------- |
+| Success | `{ success: true, data: {...} }`       |
+| Error   | `{ error: "message", details: [...] }` |
+
+---
+
+## Setup Steps
+
+1. Create project directory
+2. `npm init -y`
+3. Install deps: `npm install express prisma zod bcrypt jsonwebtoken`
+4. Configure Prisma
+5. `npm run db:push`
+6. `npm run dev`
+
+---
+
+## Best Practices
+
+- Layer architecture (routes → controllers → services)
+- Validate all inputs with Zod
+- Centralized error handling
+- Environment-based config
+- Use Prisma for type-safe DB access

package/skills/app-builder/templates/flutter-app/TEMPLATE.md

@@ -0,0 +1,90 @@
+---
+name: flutter-app
+description: Flutter mobile app template principles. Riverpod, Go Router, clean architecture.
+---
+
+# Flutter App Template
+
+## Tech Stack
+
+| Component  | Technology   |
+| ---------- | ------------ |
+| Framework  | Flutter 3.x  |
+| Language   | Dart 3.x     |
+| State      | Riverpod 2.0 |
+| Navigation | Go Router    |
+| HTTP       | Dio          |
+| Storage    | Hive         |
+
+---
+
+## Directory Structure
+
+```
+project_name/
+├── lib/
+│   ├── main.dart
+│   ├── app.dart
+│   ├── core/
+│   │   ├── constants/
+│   │   ├── theme/
+│   │   ├── router/
+│   │   └── utils/
+│   ├── features/
+│   │   ├── auth/
+│   │   │   ├── data/
+│   │   │   ├── domain/
+│   │   │   └── presentation/
+│   │   └── home/
+│   ├── shared/
+│   │   ├── widgets/
+│   │   └── providers/
+│   └── services/
+│       ├── api/
+│       └── storage/
+├── test/
+└── pubspec.yaml
+```
+
+---
+
+## Architecture Layers
+
+| Layer        | Contents                    |
+| ------------ | --------------------------- |
+| Presentation | Screens, Widgets, Providers |
+| Domain       | Entities, Use Cases         |
+| Data         | Repositories, Models        |
+
+---
+
+## Key Packages
+
+| Package             | Purpose          |
+| ------------------- | ---------------- |
+| flutter_riverpod    | State management |
+| riverpod_annotation | Code generation  |
+| go_router           | Navigation       |
+| dio                 | HTTP client      |
+| freezed             | Immutable models |
+| hive                | Local storage    |
+
+---
+
+## Setup Steps
+
+1. `flutter create {{name}} --org com.{{bundle}}`
+2. Update `pubspec.yaml`
+3. `flutter pub get`
+4. Run code generation: `dart run build_runner build`
+5. `flutter run`
+
+---
+
+## Best Practices
+
+- Feature-first folder structure
+- Riverpod for state, React Query pattern for server state
+- Freezed for immutable data classes
+- Go Router for declarative navigation
+- Material 3 theming