@slycode/slycode 0.1.19 → 0.2.0

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 (89) hide show
  1. package/dist/web/.next/BUILD_ID +1 -1
  2. package/dist/web/.next/build-manifest.json +2 -2
  3. package/dist/web/.next/server/app/_global-error.html +2 -2
  4. package/dist/web/.next/server/app/_global-error.rsc +1 -1
  5. package/dist/web/.next/server/app/_global-error.segments/__PAGE__.segment.rsc +1 -1
  6. package/dist/web/.next/server/app/_global-error.segments/_full.segment.rsc +1 -1
  7. package/dist/web/.next/server/app/_global-error.segments/_head.segment.rsc +1 -1
  8. package/dist/web/.next/server/app/_global-error.segments/_index.segment.rsc +1 -1
  9. package/dist/web/.next/server/app/_global-error.segments/_tree.segment.rsc +1 -1
  10. package/dist/web/.next/server/app/_not-found.html +1 -1
  11. package/dist/web/.next/server/app/_not-found.rsc +1 -1
  12. package/dist/web/.next/server/app/_not-found.segments/_full.segment.rsc +1 -1
  13. package/dist/web/.next/server/app/_not-found.segments/_head.segment.rsc +1 -1
  14. package/dist/web/.next/server/app/_not-found.segments/_index.segment.rsc +1 -1
  15. package/dist/web/.next/server/app/_not-found.segments/_not-found/__PAGE__.segment.rsc +1 -1
  16. package/dist/web/.next/server/app/_not-found.segments/_not-found.segment.rsc +1 -1
  17. package/dist/web/.next/server/app/_not-found.segments/_tree.segment.rsc +1 -1
  18. package/dist/web/.next/server/app/page_client-reference-manifest.js +1 -1
  19. package/dist/web/.next/server/app/project/[id]/page_client-reference-manifest.js +1 -1
  20. package/dist/web/.next/server/chunks/[root-of-the-server]__46b023d4._.js +1 -1
  21. package/dist/web/.next/server/chunks/[root-of-the-server]__4c7995bf._.js +1 -1
  22. package/dist/web/.next/server/chunks/[root-of-the-server]__4d0d3464._.js +1 -1
  23. package/dist/web/.next/server/chunks/[root-of-the-server]__543058c2._.js +3 -3
  24. package/dist/web/.next/server/chunks/[root-of-the-server]__6d330d40._.js +1 -1
  25. package/dist/web/.next/server/chunks/[root-of-the-server]__884d73e4._.js +1 -1
  26. package/dist/web/.next/server/chunks/[root-of-the-server]__949bb248._.js +1 -1
  27. package/dist/web/.next/server/chunks/[root-of-the-server]__949d814c._.js +1 -1
  28. package/dist/web/.next/server/chunks/[root-of-the-server]__aa814a86._.js +1 -1
  29. package/dist/web/.next/server/chunks/[root-of-the-server]__ad64e04f._.js +2 -2
  30. package/dist/web/.next/server/chunks/[root-of-the-server]__baa99257._.js +1 -1
  31. package/dist/web/.next/server/chunks/[root-of-the-server]__bbb4b3ac._.js +1 -1
  32. package/dist/web/.next/server/chunks/[root-of-the-server]__bf286c26._.js +1 -1
  33. package/dist/web/.next/server/chunks/[root-of-the-server]__ce429522._.js +1 -1
  34. package/dist/web/.next/server/chunks/[root-of-the-server]__d38c7a96._.js +1 -1
  35. package/dist/web/.next/server/chunks/[root-of-the-server]__e9b0e744._.js +1 -1
  36. package/dist/web/.next/server/chunks/[root-of-the-server]__f1fe18e6._.js +2 -2
  37. package/dist/web/.next/server/chunks/ssr/[root-of-the-server]__677b7660._.js +1 -1
  38. package/dist/web/.next/server/chunks/ssr/[root-of-the-server]__79c0188d._.js +1 -1
  39. package/dist/web/.next/server/chunks/ssr/src_lib_registry_ts_2fc87c9c._.js +1 -1
  40. package/dist/web/.next/server/pages/404.html +1 -1
  41. package/dist/web/.next/server/pages/500.html +2 -2
  42. package/dist/web/.next/static/chunks/7660448872d80e27.js +4 -0
  43. package/dist/web/.next/static/chunks/{49ff6bc5c5e30161.js → b694f741bb34ac84.js} +1 -1
  44. package/dist/web/src/components/ClaudeTerminalPanel.tsx +4 -0
  45. package/dist/web/src/lib/store-scanner.ts +70 -10
  46. package/dist/web/tsconfig.tsbuildinfo +1 -1
  47. package/package.json +1 -1
  48. package/templates/kanban-seed.json +1 -1
  49. package/dist/store/.backups/actions/onboard.md +0 -33
  50. package/dist/store/.backups/actions/review.md +0 -37
  51. package/dist/store/.backups/actions/show-card.md +0 -20
  52. package/dist/store/.backups/checkpoint/SKILL.md +0 -43
  53. package/dist/store/.backups/context-priming/SKILL.md +0 -153
  54. package/dist/store/.backups/context-priming/references/area-index.md +0 -101
  55. package/dist/store/.backups/context-priming/references/areas/claude-actions.md +0 -120
  56. package/dist/store/.backups/context-priming/references/areas/messaging.md +0 -177
  57. package/dist/store/.backups/context-priming/references/areas/scripts-deployment.md +0 -138
  58. package/dist/store/.backups/context-priming/references/areas/skills.md +0 -135
  59. package/dist/store/.backups/context-priming/references/areas/terminal-bridge.md +0 -232
  60. package/dist/store/.backups/context-priming/references/areas/web-frontend.md +0 -252
  61. package/dist/store/.backups/context-priming/references/maintenance.md +0 -128
  62. package/dist/store/.ignored-updates.json +0 -37
  63. package/dist/store/actions/analyse-implementation.md +0 -72
  64. package/dist/store/actions/archive.md +0 -36
  65. package/dist/store/actions/clear.md +0 -13
  66. package/dist/store/actions/complete.md +0 -34
  67. package/dist/store/actions/continue.md +0 -20
  68. package/dist/store/agents/doc-updater.md +0 -619
  69. package/dist/store/mcp/context7.json +0 -8
  70. package/dist/store/skills/claude-code-docs-maintainer/SKILL.md +0 -168
  71. package/dist/store/skills/create-command/SKILL.md +0 -92
  72. package/dist/store/skills/doc-discovery/SKILL.md +0 -18
  73. package/dist/store/skills/doc-update/SKILL.md +0 -15
  74. package/dist/store/skills/dummy/SKILL.md +0 -22
  75. package/dist/store/skills/interactive-explainer/SKILL.md +0 -557
  76. package/dist/store/skills/interactive-explainer/assets/base_template.html +0 -780
  77. package/dist/store/skills/interactive-explainer/references/design_patterns.md +0 -486
  78. package/dist/store/skills/interactive-explainer/references/visualization_libraries.md +0 -512
  79. package/dist/store/skills/problem_summary/SKILL.md +0 -11
  80. package/dist/store/skills/reference-fetch/SKILL.md +0 -206
  81. package/dist/store/skills/skill-creator/LICENSE.txt +0 -202
  82. package/dist/store/skills/skill-creator/SKILL.md +0 -246
  83. package/dist/store/skills/skill-creator/scripts/init_skill.py +0 -303
  84. package/dist/store/skills/skill-creator/scripts/package_skill.py +0 -110
  85. package/dist/store/skills/skill-creator/scripts/quick_validate.py +0 -65
  86. package/dist/web/.next/static/chunks/600359dcf0f0daac.js +0 -4
  87. /package/dist/web/.next/static/{ilZDkIBsZqGYxOIGxgcnT → BbBq5FNe-sYRKe8Pc24UW}/_buildManifest.js +0 -0
  88. /package/dist/web/.next/static/{ilZDkIBsZqGYxOIGxgcnT → BbBq5FNe-sYRKe8Pc24UW}/_clientMiddlewareManifest.json +0 -0
  89. /package/dist/web/.next/static/{ilZDkIBsZqGYxOIGxgcnT → BbBq5FNe-sYRKe8Pc24UW}/_ssgManifest.js +0 -0
@@ -1,252 +0,0 @@
1
- # Web Frontend
2
-
3
- Updated: 2026-02-14
4
-
5
- ## Overview
6
-
7
- Next.js 16 command center for project management. Features project cards with health scoring, kanban boards with drag-drop, card modals, command configuration, system health monitoring, cross-project toolkit/asset management, global search, activity feed, project scaffolding, and graceful reconnection handling. Neon-minimalist theme (SlyCode Neon) with Tailwind CSS v4, featuring lane-colored gradients, SVG noise textures, and theme-aware terminal styling.
8
-
9
- ## Key Files
10
-
11
- ### Pages & Layout
12
- - `web/src/app/page.tsx` - Home dashboard, lists projects from registry
13
- - `web/src/app/project/[id]/page.tsx` - Project detail page with kanban
14
- - `web/src/components/ProjectPageClient.tsx` - Client wrapper for project pages, global terminal activity polling
15
- - `web/src/components/ProjectView.tsx` - Project view wrapper, manages archive toggle state
16
-
17
- ### Core Components
18
- - `web/src/components/Dashboard.tsx` - Project card grid + Toolkit tab, global search, number-key shortcuts
19
- - `web/src/components/ProjectKanban.tsx` - Kanban board container, drag-drop logic
20
- - `web/src/components/KanbanColumn.tsx` - Stage columns (backlog, design, impl, testing, done)
21
- - `web/src/components/KanbanCardItem.tsx` - Individual card, status indicators, active glow effect
22
- - `web/src/components/CardModal.tsx` - Full card editor with dynamic tabs, edit session protection
23
- - `web/src/components/ProjectHeader.tsx` - Header with Commands, Archive toggle, HealthMonitor
24
-
25
- ### Project Management
26
- - `web/src/components/ProjectCard.tsx` - Enhanced project card with health dot, platform badges, edit/delete
27
- - `web/src/components/AddProjectModal.tsx` - Multi-phase project creation wizard (details → analysis → scaffold → done)
28
- - `web/src/components/HealthDot.tsx` - Health score indicator with tooltip (green/amber/red)
29
- - `web/src/components/PlatformBadges.tsx` - Detected AI platform badges (Claude, Gemini, Codex)
30
- - `web/src/components/SearchBar.tsx` - Global/contextual search across all kanban cards
31
-
32
- ### Terminal & Commands
33
- - `web/src/components/ClaudeTerminalPanel.tsx` - Reusable terminal with provider selector, startupCommands/activeCommands, card area filtering
34
- - `web/src/components/Terminal.tsx` - xterm.js terminal with ConnectionManager integration
35
- - `web/src/components/CommandConfigModal.tsx` - Command configuration UI with Command Assistant terminal
36
- - `web/src/components/GlobalClaudePanel.tsx` - Floating panel for project-wide session, supports session/CWD/class overrides
37
-
38
- ### Toolkit & Assets
39
- - `web/src/components/ToolkitTab.tsx` - Asset management tab with matrix view and pending changes
40
- - `web/src/components/AssetMatrix.tsx` - Cross-project asset deployment matrix with click-to-deploy/remove
41
- - `web/src/components/AssetViewer.tsx` - Modal viewer for asset content with frontmatter display
42
-
43
- ### Activity & Content
44
- - `web/src/components/ActivityFeed.tsx` - Collapsible event log with day grouping and stage indicators
45
- - `web/src/components/MarkdownContent.tsx` - Markdown renderer using react-markdown with GFM support
46
-
47
- ### Health & Connection
48
- - `web/src/components/HealthMonitor.tsx` - System stats widget (CPU, memory, terminals)
49
- - `web/src/components/ConnectionStatusIndicator.tsx` - Reconnection toast indicator
50
- - `web/src/lib/connection-manager.ts` - Centralized SSE reconnection with Page Visibility API
51
-
52
- ### Hooks
53
- - `web/src/hooks/useConnectionStatus.ts` - Hook for connection state subscription
54
- - `web/src/hooks/useKeyboardShortcuts.ts` - Keyboard navigation (1-9 project jump, Escape)
55
- - `web/src/hooks/useCommandsConfig.ts` - Polling-based commands config loader (30s intervals)
56
- - `web/src/hooks/usePolling.ts` - Generic polling hook
57
-
58
- ### Utilities
59
- - `web/src/lib/types.ts` - All shared types (see Data Models)
60
- - `web/src/lib/claude-actions.ts` - getStartupCommands(), getActiveCommands(), renderTemplate()
61
- - `web/src/lib/registry.ts` - Project registry loader with kanban, health scoring, platform detection
62
- - `web/src/lib/paths.ts` - Dynamic path resolution for SlyCode root and project directories
63
- - `web/src/lib/kanban-paths.ts` - Project-aware kanban file path resolution with tiered backup
64
- - `web/src/lib/asset-scanner.ts` - Asset scanning, frontmatter parsing, version comparison, platform detection
65
- - `web/src/lib/event-log.ts` - Append-only activity log with filtering/querying (500 event cap)
66
- - `web/src/lib/health-score.ts` - Health score calculator with configurable weights
67
- - `web/src/lib/tab-sync.ts` - Cross-tab synchronization using BroadcastChannel API
68
-
69
- ### API Routes
70
- - `web/src/app/api/kanban/route.ts` - Kanban CRUD
71
- - `web/src/app/api/bridge/[...path]/route.ts` - Bridge proxy
72
- - `web/src/app/api/commands/route.ts` - Commands CRUD
73
- - `web/src/app/api/commands/stream/route.ts` - SSE for command file changes
74
- - `web/src/app/api/system-stats/route.ts` - CPU/memory metrics
75
- - `web/src/app/api/areas/route.ts` - Available areas list
76
- - `web/src/app/api/terminal-classes/route.ts` - Terminal class definitions
77
- - `web/src/app/api/claude-actions/route.ts` - Commands in ClaudeActionsConfig format
78
- - `web/src/app/api/toolkit/route.ts` - Scan all project assets, build matrix
79
- - `web/src/app/api/toolkit/sync/route.ts` - Batch deploy/remove assets
80
- - `web/src/app/api/toolkit/import/route.ts` - Import asset from project to workspace
81
- - `web/src/app/api/events/route.ts` - Query activity log with filters
82
- - `web/src/app/api/search/route.ts` - Cross-project card search
83
- - `web/src/app/api/projects/route.ts` - List/create projects
84
- - `web/src/app/api/projects/[id]/route.ts` - GET/PUT/DELETE individual project
85
- - `web/src/app/api/projects/analyze/route.ts` - Analyze directory before scaffolding
86
- - `web/src/app/api/providers/route.ts` - GET/PUT for providers.json (provider list + stage defaults)
87
- - `web/src/app/api/file/route.ts` - Read files from approved directories
88
- - `web/src/app/api/git-status/route.ts` - Git status for projects
89
-
90
- ## Key Functions
91
-
92
- - `ProjectKanban.handleDragEnd()` - Reorders cards, handles cross-column moves
93
- - `ConnectionManager.createManagedEventSource()` - Auto-reconnecting SSE with backoff
94
- - `getStartupCommands(commands, terminalClass, hasHistory)` - Filter commands for session start
95
- - `getActiveCommands(commands, terminalClass)` - Filter commands for running session toolbar
96
- - `scanProjectAssets()` - Scan commands/skills/agents across projects, build matrix
97
- - `calculateHealthScore()` - Score 0-100 based on configurable weighted factors
98
-
99
- ## CardModal Tabs
100
-
101
- - **Details** - Edit fields, dropdowns for stage/priority, editable areas/tags chips, delete button
102
- - **Design** - Shows if `design_ref` exists, renders markdown with copy path button
103
- - **Feature** - Shows if `feature_ref` exists, renders markdown
104
- - **Test** - Shows if `test_ref` exists, renders markdown
105
- - **Checklist** - Interactive checkboxes with progress bar (uses ref-based state for rapid clicks)
106
- - **Terminal** - AI session with provider selector, auto-connect, startupCommands/activeCommands
107
-
108
- CardModal uses edit session protection: last-known-value tracking, 2000ms grace period for field editing, prevents overwriting active edits from external updates.
109
-
110
- ## Health Scoring
111
-
112
- - **Factors**: outdated assets, stale cards, unresolved problems, missing CLAUDE.md, non-compliant frontmatter
113
- - **Levels**: green (≥80), amber (≥50), red (<50)
114
- - **Display**: HealthDot component with tooltip showing score breakdown
115
- - Located on ProjectCard in Dashboard
116
-
117
- ## Toolkit (Asset Management)
118
-
119
- - Scans commands/skills/agents across all projects
120
- - Frontmatter validation: name, version, updated, description required
121
- - Version comparison for detecting outdated assets
122
- - Matrix view: rows=assets, columns=projects, cells=status
123
- - Batch operations: deploy to / remove from projects
124
- - Import from project back to workspace
125
-
126
- ## Connection Management
127
-
128
- - `ConnectionManager` - Singleton managing all SSE connections
129
- - Page Visibility API detection for sleep/wake cycles
130
- - Exponential backoff with jitter (1s initial, 30s max)
131
- - `ConnectionStatusIndicator` - Toast showing "Reconnecting..." during recovery
132
-
133
- ## Data Models
134
-
135
- - `KanbanCard` - id, title, description, type, priority, order, areas[], tags[], problems[], checklist[], archived?, design_ref?, feature_ref?, test_ref?, claude_session?
136
- - `Command` - label, description, group, cardTypes[], prompt, visibleIn, scope, sessionState
137
- - `BridgeStats` - bridgeTerminals, connectedClients, activelyWorking, sessions[]
138
- - `SystemStats` - cpu (0-100), memory {used, total}, swap {used, total}
139
- - `SessionActivity` - name, status, lastOutputAt, isActive
140
- - `AssetInfo` - name, type, version, updated, description, filePath, frontmatter
141
- - `AssetCell` - status (present|outdated|missing|extra), masterVersion?, projectVersion?
142
- - `ToolkitData` - rows (AssetRow[]), projects (string[])
143
- - `HealthScore` - score (0-100), level (green|amber|red), factors[]
144
- - `ActivityEvent` - type, timestamp, project, detail, cardId?
145
- - `SearchResult` - card, project, matchedFields[]
146
- - `ProjectWithBacklog` - extends Project with assets, gitUncommitted, healthScore, platforms, lastActivity, activeSessions
147
- - `ProvidersData` - providers (Record<id, ProviderConfig>), defaults (stages, global, projects)
148
- - `ProviderConfig` - id, displayName, command, permissions, resume, prompt
149
-
150
- ## Design System — SlyCode Neon Theme
151
-
152
- ### Philosophy
153
- Neon-minimalist aesthetic. Clean surfaces with subtle texture for life and depth. Never sterile/flat, never over-the-top. The theme should feel like a premium tool — atmospheric but professional. Light mode is clean with color; dark mode is moody with glow.
154
-
155
- ### Color Palette
156
- - **Neon Blue** (`--neon-blue: #00bfff`) — Primary accent, design/implementation lanes, links, active states
157
- - **Neon Orange** (`--neon-orange: #ff8c00`) — Global/project terminal headers, warnings
158
- - **Red-Orange** (`#ff6a33`) — Testing lane (NOT standard orange, which looks brown in dark mode)
159
- - **Green** — Done lane, success states, running indicators
160
- - **Void** — Neutral grey scale for backgrounds, borders, muted text
161
- - **Red** (`#ff3b5c`) — Critical/bug indicators, stop buttons
162
-
163
- ### Critical Color Lesson
164
- Dark-end scale colors (e.g. `neon-orange-950 = #2b1700`) are inherently brown. For vibrant dark mode colors, use the BRIGHT color at LOW OPACITY (e.g. `neon-orange-400/15`) instead of dark scale values.
165
-
166
- ### Texture System (globals.css)
167
- Three-layer texture approach for gradient surfaces:
168
-
169
- 1. **Fine grain** (`.grain`) — High-frequency SVG feTurbulence noise (`baseFrequency: 0.65`), overlay blend. Desaturate with `feColorMatrix type='saturate' values='0'` when color neutrality matters.
170
- 2. **Perlin noise** (`.depth-glow`) — Low-frequency organic texture (`baseFrequency: 0.015` light, `0.012` dark), large 400px tiles. Light mode uses `screen` blend (lightens), dark mode uses `soft-light`. Masked with left-to-right gradient fade.
171
- 3. **Terminal texture** (`.terminal-texture`) — CRT-like grain + vignette + lane-colored tint via `--terminal-tint` CSS variable. Box-shaped mask (edges visible, centre clear). Light: `soft-light` blend. Dark: `screen` blend (avoids warm/red cast from `soft-light` on dark backgrounds).
172
-
173
- ### Blend Mode Rules
174
- - `soft-light` on dark backgrounds produces warm/red cast — avoid for dark mode textures
175
- - `overlay` is neutral but can be invisible on very dark surfaces
176
- - `screen` always adds light — use for dark mode when you need visible texture
177
- - `mix-blend-multiply` makes white backgrounds transparent (light mode logos)
178
- - `mix-blend-lighten` makes black backgrounds transparent (dark mode logos)
179
- - `filter: drop-shadow()` traces the ALPHA boundary — creates rectangular glow on images with opaque backgrounds. Incompatible with blend-mode logo transparency.
180
-
181
- ### Logo Handling
182
- Logos have opaque backgrounds (white for light, black for dark). Two `<img>` tags per location:
183
- - Light: `mix-blend-multiply dark:hidden`
184
- - Dark: `mix-blend-lighten hidden dark:block`
185
- - All CSS drop-shadow/filter glow DISABLED (creates rectangular artifacts with blend modes). Logos have baked-in glow.
186
- - Files: `slycode_light.png` / `slycode.png` (hero), `slycode_logo_light.png` / `slycode_logo.png` (nav)
187
-
188
- ### Lane-Colored Theming
189
- Stage colors flow through multiple layers:
190
- - **KanbanColumn headers** — `colorClasses` map with header gradient, text, count badge, border
191
- - **CardModal header/tabs** — `stageModalStyles` map with gradients, borders per stage. Uses transparency (85% → 50%) for subtle glass quality
192
- - **CardModal footer** — `stageTerminalColors` with colored top border
193
- - **Terminal tint** — `stageTerminalTint` map provides rgba color → passed as `tintColor` prop → sets `--terminal-tint` CSS variable on terminal overlay
194
-
195
- ### Gradient Direction Convention
196
- Left-to-right, vibrant-to-soft. The left/start side is always the stronger color, fading lighter toward the right. Never center-out fades (looks artificial).
197
-
198
- ### Button Aesthetic — Neon Glass
199
- Terminal/action buttons use semi-transparent backgrounds with colored borders and hover glow:
200
- ```
201
- border border-{color}-400/40 bg-{color}-400/15 text-{color}-400
202
- hover:bg-{color}-400/25 hover:shadow-[0_0_12px_rgba(...,0.3)]
203
- ```
204
-
205
- ### Health Monitor
206
- Uses inline gradient fills + glow shadows (not flat CSS classes):
207
- - Normal: `linear-gradient(90deg, #00e676, #00bfff)` + blue glow
208
- - Warning: `linear-gradient(90deg, #ff8c00, #ffaa00)` + orange glow
209
- - Critical: `linear-gradient(90deg, #ff3b5c, #ff6b81)` + red glow
210
-
211
- ### Terminal Background
212
- Theme-aware: `#222228` (light mode, slightly lighter) / `#1a1a1a` (dark mode). Detected at xterm mount via `document.documentElement.classList.contains('dark')`. Wrapper divs use `bg-[#222228] dark:bg-[#1a1a1a]`.
213
-
214
- ### Dark Mode Borders
215
- Card modals get colored outer borders in dark mode (`dark:border dark:border-{color}/25-30`). Section dividers (header/tabs/terminal) use lane colors in both modes.
216
-
217
- ## Patterns & Invariants
218
-
219
- - Cards auto-save on changes via `/api/kanban` PUT
220
- - Kanban data stored in `documentation/kanban.json` per project
221
- - Stage order: backlog → design → implementation → testing → done
222
- - Active glow: `active-glow-card` CSS class with pulse animation (2s activity threshold)
223
- - Commands use `startupCommands` (session start) and `activeCommands` (running toolbar)
224
- - SSE connections managed centrally via ConnectionManager for reconnection
225
- - Dynamic path resolution via paths.ts (no hardcoded paths)
226
- - Cross-tab sync via BroadcastChannel API
227
- - Number keys 1-9 jump to projects, Escape closes modals
228
- - Event log capped at 500 entries, append-only
229
- - Session names include provider segment: `{projectId}:{provider}:card:{cardId}`
230
- - Provider selector shown on no-session screen, pre-filled from stage defaults
231
- - CardModal detects existing session's provider from session name for pre-selection
232
- - ProjectKanban/ProjectPageClient use regex patterns to match both new and legacy session names
233
-
234
- ## When to Expand
235
-
236
- - Editing card behavior → CardModal.tsx
237
- - Kanban drag/drop issues → ProjectKanban.tsx, KanbanColumn.tsx
238
- - Adding new card fields → types.ts, CardModal.tsx
239
- - Command configuration → CommandConfigModal.tsx, data/commands.json
240
- - Health monitoring → HealthMonitor.tsx, /api/system-stats
241
- - Connection issues → connection-manager.ts, ConnectionStatusIndicator.tsx
242
- - Terminal panel behavior → ClaudeTerminalPanel.tsx
243
- - Provider selection → ClaudeTerminalPanel.tsx, /api/providers, data/providers.json
244
- - Provider detection for existing sessions → CardModal.tsx (session name parsing)
245
- - Asset management → asset-scanner.ts, ToolkitTab.tsx, AssetMatrix.tsx
246
- - Health scoring → health-score.ts, HealthDot.tsx
247
- - Activity feed → event-log.ts, ActivityFeed.tsx
248
- - Project scaffolding → AddProjectModal.tsx, /api/projects
249
- - Search → SearchBar.tsx, /api/search
250
- - Path resolution → paths.ts, kanban-paths.ts
251
- - Keyboard shortcuts → useKeyboardShortcuts.ts
252
- - Theme/design system → globals.css (texture classes), CardModal.tsx (stageModalStyles), KanbanColumn.tsx (colorClasses), GlobalClaudePanel.tsx (terminal header), Terminal.tsx (tintColor, terminal-texture)
@@ -1,128 +0,0 @@
1
- # Maintenance Doctrine
2
-
3
- Rules for maintaining context-priming references. Changes to this file require user approval.
4
-
5
- ## Area File Structure
6
-
7
- Area files should be as lean as the area requires. Include sections that add value; omit those that don't.
8
-
9
- **Always include:**
10
- ```markdown
11
- # [Area Name]
12
-
13
- Updated: YYYY-MM-DD
14
-
15
- ## Overview
16
- What this area does, boundaries. 2-3 sentences.
17
-
18
- ## Key Files
19
- - `file.py` - purpose
20
- [Most important files/modules]
21
-
22
- ## When to Expand
23
- - [task] → [files to open]
24
- ```
25
-
26
- **Include when relevant:**
27
-
28
- | Section | When to include |
29
- |---------|-----------------|
30
- | Key Functions | Area has important entry points, APIs, or non-obvious control flow |
31
- | Data Models | Area defines data structures used internally or externally |
32
- | Shared Objects | Area defines or consumes objects used across multiple areas |
33
- | Patterns & Invariants | Area has critical rules that must hold |
34
- | Interfaces | Area connects to other areas with data flow |
35
-
36
- **Section formats (when used):**
37
-
38
- ```markdown
39
- ## Key Functions
40
- - `process_message()` in handlers.py - entry point for incoming messages
41
-
42
- ## Data Models
43
- - `Message` (models.py) - id, content, sender_id, timestamp | core envelope
44
-
45
- ## Shared Objects
46
- - `Message` - DEFINED HERE, used by: frontend, api, workers
47
- - `Config` - defined in core, IMPORTED HERE
48
-
49
- ## Patterns & Invariants
50
- - Auth middleware runs before handlers
51
-
52
- ## Interfaces
53
- - → frontend: sends Message via WebSocket
54
- - ← api: receives Request, returns Response
55
- ```
56
-
57
- Keep area files under 200 lines. Simple areas may be 20-30 lines; complex areas will be longer.
58
-
59
- **Shared Objects note**: When present, prevents duplicate definitions. Mark canonical location.
60
-
61
- ## Defragmentation
62
-
63
- **When to defrag an area:**
64
- - Information is scattered/duplicated within the file
65
- - Sections contain outdated content mixed with current
66
- - File has grown beyond 200 lines
67
- - Reading the file doesn't quickly answer "what do I need to know?"
68
-
69
- **Defrag process:**
70
- 1. Read the entire area file
71
- 2. Identify: duplicates, outdated info, poor organization
72
- 3. Consolidate related information
73
- 4. Remove obsolete content (don't comment it out - delete)
74
- 5. Verify remaining content is accurate against current code
75
- 6. Update the `Updated` date
76
-
77
- **Consult user before defragging if:**
78
- - Multiple areas need simultaneous restructuring
79
- - Unsure whether information is obsolete or still relevant
80
- - Defrag would take significant time
81
-
82
- ## Area Separation
83
-
84
- **Heuristics for deciding areas:**
85
- - Group by logical module/subsystem, not by file type
86
- - An area should be loadable and useful independently
87
- - If two areas are always loaded together, consider merging
88
- - If an area covers unrelated concerns, consider splitting
89
-
90
- **When to split an area:**
91
- - File exceeds 200 lines despite being concise
92
- - Contains distinct subsystems that don't interact
93
- - Load-when triggers have diverged (some tasks need part A, others need part B)
94
-
95
- **When to merge areas:**
96
- - Two areas are nearly always loaded together
97
- - Combined size would still be under 150 lines
98
- - Separation creates artificial boundaries
99
-
100
- **Cross-references:**
101
- - Areas can note "see also: [other-area]" for related context
102
- - Don't auto-load chains - let the index's load-when guide loading
103
- - If area A heavily depends on area B, note this in A's Interfaces section
104
-
105
- ## Note Pruning
106
-
107
- Notes in area-index.md capture learnings. Prune when:
108
- - Note contradicts newer information (keep newer)
109
- - Code changed and note no longer applies
110
- - Note is vague or not actionable
111
- - Area exceeds 10 notes
112
-
113
- **Pruning is lightweight** - remove stale notes during routine updates, don't treat as separate task.
114
-
115
- ## New Project Initialization
116
-
117
- When skill is introduced to a new codebase:
118
-
119
- 1. Clear `areas/` directory
120
- 2. Reset area-index.md to template state
121
- 3. Keep SKILL.md and maintenance.md intact
122
- 4. Scan project structure:
123
- - Look for obvious module boundaries (directories, packages)
124
- - Check build configs (package.json, pyproject.toml, etc.)
125
- - Read CLAUDE.md for existing documentation pointers
126
- 5. Propose 3-6 initial areas to user
127
- 6. After approval, create area files with initial discovery
128
- 7. Mark all as freshly created - validate through actual use
@@ -1,37 +0,0 @@
1
- {
2
- "skills/kanban": "1.3.0",
3
- "skills/code-review": "1.0.0",
4
- "actions/onboard": "d2a2dd1bcb97",
5
- "actions/show-card": "185ccdc4beb0",
6
- "actions/approve": "0d1097e72a69",
7
- "actions/archive": "44999be606ab",
8
- "actions/checkpoint": "1b87d19a1c22",
9
- "actions/clear": "b3f1a7a21337",
10
- "actions/configure-commands": "778d11c6df39",
11
- "actions/context": "830cf4fc47d4",
12
- "actions/continue": "a808fa97513e",
13
- "actions/convert-asset": "47d33ad765a1",
14
- "actions/create-card": "3aa7f18c0807",
15
- "actions/explore": "d67b7785deb0",
16
- "actions/organise-backlog": "28e9fb9bd19c",
17
- "actions/summarize": "6ce55b060254",
18
- "actions/test-review": "baa161179c9d",
19
- "actions/update-priming": "685464a284c2",
20
- "actions/analyse-implementation": "f380bedf7c60",
21
- "actions/chore": "da6c88ff5a07",
22
- "actions/complete": "4da58630f469",
23
- "actions/debug": "721c9ce48ed3",
24
- "actions/deep-design": "02146223d052",
25
- "actions/design-requirements": "c214c49eb284",
26
- "actions/implement": "0793a438b277",
27
- "actions/make-feature": "b4c2763bc890",
28
- "actions/quick-fix": "a93f3ce3123d",
29
- "actions/review": "29c6fbf1448f",
30
- "skills/checkpoint": "0d72f0dc3b87",
31
- "skills/context-priming": "4979c7d2ff4f",
32
- "skills/design": "c2cba0b138f4",
33
- "skills/feature": "aeff2aad7309",
34
- "skills/implement": "f6dca53805ab",
35
- "skills/messaging": "1fbb11161959",
36
- "skills/chore": "dc1fb83dbeca"
37
- }
@@ -1,72 +0,0 @@
1
- ---
2
- name: analyse-implementation
3
- version: 1.0.0
4
- label: "Analyse"
5
- description: "Analyse the implementation for consistency, bugs, bloat, and card alignment"
6
- group: "Card Actions"
7
- placement: both
8
- scope: global
9
- classes:
10
- implementation: 20
11
- testing: 80
12
- ---
13
-
14
- {{cardContext}}
15
-
16
- ---
17
-
18
- ## Your Task
19
-
20
- Perform a **thorough analysis** of the implementation for this card.
21
-
22
- > Card details are provided above. If you need checklist status, notes from prior sessions, or problem IDs, run `sly-kanban show {{card.id}}` before proceeding.
23
-
24
- **Step 1 - Gather context:**
25
- Read the card description, acceptance criteria, design_ref and feature_ref (if they exist) to understand what was expected.
26
-
27
- **Step 2 - Prime context:**
28
- Use `/context-priming` with the card's **Areas** to load the relevant codebase patterns, conventions, and architecture.
29
-
30
- **Step 3 - Identify changed files:**
31
- Use git history, the feature spec, and the card areas to identify all files that were added or modified as part of this implementation. Read every one of them thoroughly.
32
-
33
- **Step 4 - Analyse against these criteria:**
34
-
35
- | Category | What to look for |
36
- |---|---|
37
- | **Pattern Consistency** | Does the new code follow the same patterns, naming conventions, file organization, and idioms as the existing codebase? Flag deviations. |
38
- | **Bugs & Logic Errors** | Off-by-one errors, null/undefined handling, missing error handling, incorrect conditionals, type mismatches, silent failures. |
39
- | **Race Conditions & Timing** | Async operations without proper awaiting, shared mutable state, event ordering assumptions, missing locks or guards, stale closures. |
40
- | **Card Alignment** | Does the implementation actually deliver what the card description and acceptance criteria specify? Is anything missing, incomplete, or going beyond scope? |
41
- | **Bloat & Complexity** | Over-engineering, unnecessary abstractions, dead code, premature generalisation, things that could be simpler. Flag anything that adds complexity without clear justification. |
42
- | **Edge Cases** | Untested boundaries - empty inputs, large inputs, concurrent access, network failures, permission errors, malformed data. |
43
- | **Security** | Injection risks, missing input validation at boundaries, exposed secrets, unsafe defaults. |
44
-
45
- **Step 5 - Produce the findings report:**
46
-
47
- Present a structured table of findings:
48
-
49
- | # | Severity | Category | File:Line | Finding | Recommendation |
50
- |---|----------|----------|-----------|---------|----------------|
51
- | 1 | critical/major/minor | Category from above | path:line | Detailed description of the issue | What should be done to fix it |
52
-
53
- Severity guide:
54
- - **critical** - Will cause bugs, data loss, or security issues in production
55
- - **major** - Significant quality issue, deviation from patterns, or missing card requirement
56
- - **minor** - Style inconsistency, minor improvement opportunity, or nitpick
57
-
58
- After the table, provide a brief **overall assessment** - is this implementation solid, or does it need work before approval?
59
-
60
- **Step 6 - Log issues on the card:**
61
-
62
- For every **critical** and **major** finding, log it as a problem on the card:
63
- ```bash
64
- sly-kanban problem {{card.id}} add "[Category] Finding description — Recommendation" --severity <major|critical>
65
- ```
66
-
67
- For **minor** findings, log them as minor:
68
- ```bash
69
- sly-kanban problem {{card.id}} add "[Category] Finding description" --severity minor
70
- ```
71
-
72
- Summarize how many issues were logged at each severity level.
@@ -1,36 +0,0 @@
1
- ---
2
- name: archive
3
- version: 1.0.0
4
- label: "Archive"
5
- description: "Archive a completed card"
6
- group: "Card Actions"
7
- placement: toolbar
8
- scope: global
9
- classes:
10
- done: 10
11
- ---
12
-
13
- {{cardContext}}
14
-
15
- ---
16
-
17
- ## Your Task
18
-
19
- Archive this completed card.
20
-
21
- **First, verify it's truly complete:**
22
- ```bash
23
- sly-kanban show {{card.id}}
24
- ```
25
-
26
- **Check:**
27
- - All work is complete
28
- - No unresolved problems
29
- - Ready to be archived for record-keeping
30
-
31
- **If ready to archive:**
32
- ```bash
33
- sly-kanban archive {{card.id}}
34
- ```
35
-
36
- This removes the card from active view but preserves it in history.
@@ -1,13 +0,0 @@
1
- ---
2
- name: clear
3
- version: 1.0.0
4
- label: "Clear"
5
- description: "Clear conversation history"
6
- group: "Utilities"
7
- placement: toolbar
8
- scope: global
9
- classes:
10
- global-terminal: 20
11
- ---
12
-
13
- /clear
@@ -1,34 +0,0 @@
1
- ---
2
- name: complete
3
- version: 1.0.0
4
- label: "Complete"
5
- description: "Wrap up implementation and move to testing"
6
- group: "Card Actions"
7
- placement: toolbar
8
- scope: global
9
- classes:
10
- implementation: 40
11
- ---
12
-
13
- {{cardContext}}
14
-
15
- ---
16
-
17
- ## Your Task
18
-
19
- Complete the implementation phase for this card.
20
-
21
- > Card details are provided above. If you need checklist status, notes from prior sessions, or problem IDs, run `sly-kanban show {{card.id}}` before proceeding.
22
-
23
- **Checklist before moving to testing:**
24
- 1. All planned work is done
25
- 2. Code is committed (use /checkpoint if needed)
26
- 3. No critical issues remain (check problems list)
27
- 4. Basic functionality verified
28
-
29
- **If ready:**
30
- ```bash
31
- sly-kanban move {{card.id}} testing
32
- ```
33
-
34
- **If not ready**, explain what's still needed.
@@ -1,20 +0,0 @@
1
- ---
2
- name: continue
3
- version: 1.0.0
4
- label: "Continue"
5
- description: "Continue working from where we left off"
6
- group: "Session"
7
- placement: startup
8
- scope: global
9
- classes:
10
- project-terminal: 10
11
- testing: 40
12
- ---
13
-
14
- {{cardContext}}
15
-
16
- ---
17
-
18
- ## Your Task
19
-
20
- Continue from where we left off. Briefly recap what was happening and what's next.