kodelyth-ecc 1.8.0 → 1.8.2
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/CLAUDE.md +1 -1
- package/VERSION +1 -1
- package/bin/kodelyth-ecc.js +54 -5
- package/install.ps1 +30 -13
- package/install.sh +11 -4
- package/package.json +1 -1
- package/rules/common/agent-intent-routing.md +96 -195
- package/.github/ISSUE_TEMPLATE/bug_report.md +0 -47
- package/.github/ISSUE_TEMPLATE/config.yml +0 -8
- package/.github/ISSUE_TEMPLATE/feature_request.md +0 -41
- package/.github/ISSUE_TEMPLATE/good_first_issue.md +0 -36
- package/.github/ISSUE_TEMPLATE/new_agent.md +0 -52
- package/.github/PULL_REQUEST_TEMPLATE.md +0 -53
- package/.github/workflows/ci.yml +0 -45
- package/.github/workflows/publish.yml +0 -60
- package/brand/concepts.svg +0 -109
- package/brand/convert.js +0 -161
- package/brand/favicon.svg +0 -7
- package/brand/fb-cover.svg +0 -34
- package/brand/fb-profile.svg +0 -21
- package/brand/kodelyth-dark.svg +0 -24
- package/brand/kodelyth-light.svg +0 -24
- package/brand/kodelyth-mark.svg +0 -20
- package/brand/package.json +0 -12
- package/docs/dashboard.md +0 -211
- package/docs/evolve.md +0 -303
- package/docs/mcp-clients.md +0 -167
- package/docs/mcp.md +0 -178
- package/docs/replay.md +0 -244
- package/docs/supply-chain.md +0 -207
- package/docs/swarm.md +0 -243
- package/skills/skill-comply/tests/test_grader.py +0 -137
- package/skills/skill-comply/tests/test_parser.py +0 -90
- package/social/card-agents.svg +0 -104
- package/social/card-install.svg +0 -58
- package/social/card-main.svg +0 -54
- package/social/facebook-v150.svg +0 -110
- package/social/fb-ad-main.svg +0 -128
- package/social/fb-post-features.svg +0 -118
- package/social/fb-post-launch.svg +0 -144
- package/social/fb-post-platforms.svg +0 -135
- package/social/github-social-preview.svg +0 -151
- package/social/hype-compound-learning.svg +0 -129
- package/social/hype-devil-mode.svg +0 -240
- package/social/hype-mcp-server.svg +0 -148
- package/social/hype-parallel-agents.svg +0 -162
- package/social/hype-stats-hero.svg +0 -138
- package/social/og-image.svg +0 -151
- package/social/readme-agents.svg +0 -138
- package/social/readme-hero.svg +0 -102
- package/social/section-agents.svg +0 -69
- package/social/section-author.svg +0 -66
- package/social/section-dashboard.svg +0 -71
- package/social/section-devil.svg +0 -66
- package/social/section-hooks.svg +0 -63
- package/social/section-install.svg +0 -54
- package/social/section-learning.svg +0 -64
- package/social/section-mcp.svg +0 -58
- package/social/section-memory.svg +0 -69
- package/social/section-parallel.svg +0 -84
- package/social/section-routing.svg +0 -63
- package/social/twitter-threads.md +0 -621
- package/social/x-card-agents-grid.svg +0 -120
- package/social/x-card-free.svg +0 -71
- package/social/x-card-hook.svg +0 -94
- package/tests/dashboard/data.test.js +0 -391
- package/tests/dashboard/server.test.js +0 -257
- package/tests/evolve/analyze.test.js +0 -169
- package/tests/evolve/proposals.test.js +0 -173
- package/tests/evolve/stats.test.js +0 -167
- package/tests/hooks/branch-name-check.test.js +0 -184
- package/tests/hooks/smart-suggest.test.js +0 -149
- package/tests/hooks/test-reminder.test.js +0 -181
- package/tests/mcp/catalog.test.js +0 -98
- package/tests/mcp/client.test.js +0 -113
- package/tests/mcp/resources-prompts.test.js +0 -70
- package/tests/mcp/tools.test.js +0 -159
- package/tests/memory/auto-recall.test.js +0 -132
- package/tests/memory/instincts.test.js +0 -258
- package/tests/memory/store.test.js +0 -203
- package/tests/replay/bundle.test.js +0 -181
- package/tests/replay/replay.test.js +0 -131
- package/tests/router/classify.test.js +0 -164
- package/tests/run-all.js +0 -55
- package/tests/safety/patterns.test.js +0 -94
- package/tests/safety/prompt-injection-guard.test.js +0 -111
- package/tests/safety/token-budget.test.js +0 -119
- package/tests/supply-chain/manifest.test.js +0 -147
- package/tests/supply-chain/sbom.test.js +0 -170
- package/tests/supply-chain/verify.test.js +0 -146
- package/tests/swarm/build-plan.test.js +0 -188
|
@@ -401,89 +401,60 @@ Trigger when the user wants a **detailed implementation blueprint for one specif
|
|
|
401
401
|
|
|
402
402
|
Trigger for non-code workflow tasks: drafting emails, scheduling, status updates, multi-channel coordination.
|
|
403
403
|
|
|
404
|
-
| Signal |
|
|
404
|
+
| Signal | Examples |
|
|
405
405
|
|---|---|
|
|
406
|
-
| Communication | "draft an email", "write a message", "reply to this", "
|
|
406
|
+
| Communication | "draft an email", "write a message", "reply to this", "slack message" |
|
|
407
407
|
| Status | "status update", "what do I tell the team", "write the incident update" |
|
|
408
408
|
|
|
409
409
|
### `seo-specialist` — SEO / metadata / search
|
|
410
410
|
|
|
411
|
-
| Signal |
|
|
411
|
+
| Signal | Examples |
|
|
412
412
|
|---|---|
|
|
413
|
-
| SEO | "SEO", "meta tags", "schema.org", "structured data", "Core Web Vitals", "sitemap", "my page doesn't rank"
|
|
413
|
+
| SEO | "SEO", "meta tags", "schema.org", "structured data", "Core Web Vitals", "sitemap", "my page doesn't rank" |
|
|
414
414
|
|
|
415
415
|
### `opensource-forker` + `opensource-sanitizer` + `opensource-packager` — Open-sourcing a project
|
|
416
416
|
|
|
417
|
-
| Signal |
|
|
417
|
+
| Signal | Examples |
|
|
418
418
|
|---|---|
|
|
419
|
-
| OSS prep | "open source this", "make this public", "
|
|
419
|
+
| OSS prep | "open source this", "make this public", "strip secrets", "remove credentials", "release as open source" |
|
|
420
420
|
|
|
421
421
|
Use the chain: `forker` → `sanitizer` → `packager`.
|
|
422
422
|
|
|
423
423
|
### `/dashboard` — Local observability dashboard
|
|
424
424
|
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
| Signal | Real human phrasing |
|
|
425
|
+
| Signal | Examples |
|
|
428
426
|
|---|---|
|
|
429
|
-
| Open dashboard | "open the dashboard", "
|
|
430
|
-
| Inspect memory | "show me what's in my memory", "browse my sessions", "see my memory store"
|
|
431
|
-
|
|
|
432
|
-
| Token budget | "what's my token budget", "see budget snapshot", "token usage overview" |
|
|
433
|
-
| Evolve tab | "show evolve proposals", "see what skills ECC proposed", "evolve tab", "review memory proposals" |
|
|
434
|
-
|
|
435
|
-
**How:** run `npx kodelyth-ecc dashboard` — opens `http://localhost:3141` in the default browser. GET-only, localhost-only, zero telemetry.
|
|
427
|
+
| Open dashboard | "open the dashboard", "show me the dashboard", "start the dashboard" |
|
|
428
|
+
| Inspect memory | "show me what's in my memory", "browse my sessions", "see my memory store" |
|
|
429
|
+
| Token / evolve | "what's my token budget", "show evolve proposals", "evolve tab" |
|
|
436
430
|
|
|
437
431
|
### `/swarm` — Parallel agent swarm in git worktrees
|
|
438
432
|
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
| Signal | Real human phrasing |
|
|
433
|
+
| Signal | Examples |
|
|
442
434
|
|---|---|
|
|
443
|
-
| Swarm request | "use the swarm", "run a swarm", "swarm this", "parallel swarm
|
|
444
|
-
| Parallel worktrees | "run agents in parallel", "
|
|
445
|
-
| Scale a task | "give me maximum throughput on this", "throw all agents at this", "run this with maximum agents" |
|
|
446
|
-
| Speed concern | "how do I run this as fast as possible", "I want to parallelize this analysis", "fastest path" |
|
|
447
|
-
|
|
448
|
-
**How:** `npx kodelyth-ecc swarm --task "<description>"` — spawns parallel agents in isolated git worktrees, aggregates results.
|
|
435
|
+
| Swarm request | "use the swarm", "run a swarm", "swarm this", "parallel swarm" |
|
|
436
|
+
| Parallel worktrees | "run agents in parallel", "spawn multiple agents", "maximum throughput" |
|
|
449
437
|
|
|
450
438
|
### `/route-model` — Cost-aware model selection
|
|
451
439
|
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
| Signal | Real human phrasing |
|
|
440
|
+
| Signal | Examples |
|
|
455
441
|
|---|---|
|
|
456
|
-
| Model choice | "which model should I use", "
|
|
457
|
-
| Cost concern | "cheapest model for this", "save tokens
|
|
458
|
-
| Tier question | "is this a trivial or complex task tier", "which tier for X", "model selection", "right model tier" |
|
|
459
|
-
| Route a task | "route this task", "what does the router say", "model router", "cost-aware routing" |
|
|
460
|
-
|
|
461
|
-
**How:** `npx kodelyth-ecc route "<task description>"` — returns the recommended model tier with reasoning.
|
|
442
|
+
| Model choice | "which model should I use", "haiku or sonnet?", "should I use opus here" |
|
|
443
|
+
| Cost concern | "cheapest model for this", "save tokens", "cost-aware routing" |
|
|
462
444
|
|
|
463
445
|
### `/memory-evolve` — Self-evolving memory proposals
|
|
464
446
|
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
| Signal | Real human phrasing |
|
|
447
|
+
| Signal | Examples |
|
|
468
448
|
|---|---|
|
|
469
|
-
| Evolve proposals | "show evolve proposals", "what has ECC learned", "memory evolution"
|
|
470
|
-
|
|
|
471
|
-
| Routing additions | "suggest routing improvements", "what routing misses happened", "improve my intent routing from usage" |
|
|
472
|
-
| Review proposals | "review pending proposals", "accept or reject proposals", "what did the analyzer find" |
|
|
473
|
-
|
|
474
|
-
**How:** `npx kodelyth-ecc evolve analyze` — analyzes BM25 memory surface data + routing misses, outputs proposals. Nothing auto-applies — the user reviews, accepts, and commits.
|
|
449
|
+
| Evolve proposals | "show evolve proposals", "what has ECC learned", "memory evolution" |
|
|
450
|
+
| Routing additions | "suggest routing improvements", "what routing misses happened" |
|
|
475
451
|
|
|
476
452
|
### `/replay` — Session replay
|
|
477
453
|
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
| Signal | Real human phrasing |
|
|
454
|
+
| Signal | Examples |
|
|
481
455
|
|---|---|
|
|
482
|
-
| Replay request | "replay a session", "re-run that session", "session replay"
|
|
483
|
-
|
|
|
484
|
-
| Bundle | "session bundle", "kodelyth.session-bundle", "export and replay", "portable session" |
|
|
485
|
-
|
|
486
|
-
**How:** `npx kodelyth-ecc replay <bundle-name>` — re-runs the session bundle, restoring agent context and workflow.
|
|
456
|
+
| Replay request | "replay a session", "re-run that session", "session replay" |
|
|
457
|
+
| Bundle | "session bundle", "export and replay", "portable session" |
|
|
487
458
|
|
|
488
459
|
---
|
|
489
460
|
|
|
@@ -497,94 +468,71 @@ Trigger when the user wants to re-run or review a past session bundle — reprod
|
|
|
497
468
|
| `debug-detective` (root cause found) | `tdd-guide` to add a regression test |
|
|
498
469
|
| `code-reviewer` (issues found) | `refactor-cleaner` to fix |
|
|
499
470
|
| `security-reviewer` (vuln found) | `tdd-guide` to add a security test |
|
|
500
|
-
| `migration-guide` (plan made) | `pr-test-analyzer` after PR is up |
|
|
501
471
|
| `architect` (design done) | `code-architect` for the first feature |
|
|
502
472
|
| `performance-optimizer` (bottleneck found) | `tdd-guide` for a perf regression test |
|
|
503
|
-
| `load-tester` (bottleneck found) | `performance-optimizer` to fix the code |
|
|
504
473
|
| `incident-commander` (incident resolved) | `debug-detective` for deeper root cause, then postmortem |
|
|
505
474
|
|
|
506
475
|
---
|
|
507
476
|
|
|
508
477
|
### `image-architect` — Image and visual generation
|
|
509
478
|
|
|
510
|
-
Trigger on ANY request for a visual, image, picture, graphic, or design asset.
|
|
479
|
+
Trigger on ANY request for a visual, image, picture, graphic, or design asset.
|
|
511
480
|
|
|
512
|
-
| Signal |
|
|
481
|
+
| Signal | Examples |
|
|
513
482
|
|---|---|
|
|
514
|
-
| Explicit request | "generate an image", "create a picture", "make a visual", "I need graphics"
|
|
515
|
-
| Hero /
|
|
516
|
-
|
|
|
517
|
-
|
|
|
518
|
-
| Marketing | "marketing images", "product screenshots", "cover image", "feature image", "promotional graphic" |
|
|
519
|
-
| Design ask | "design a logo", "create artwork", "make it look good", "I need something for the homepage", "make it more visual", "give it some flair" |
|
|
520
|
-
| Implicit visual need | "my site looks plain", "the site looks boring", "it looks empty", "it needs something visual", "it's too plain", "the page looks bare" |
|
|
521
|
-
| App branding | "app icon", "brand image", "I need a visual identity", "something that looks professional" |
|
|
483
|
+
| Explicit request | "generate an image", "create a picture", "make a visual", "I need graphics" |
|
|
484
|
+
| Hero / social | "hero image", "banner", "OG image", "social preview", "GitHub card", "Twitter card" |
|
|
485
|
+
| Implicit visual need | "my site looks plain", "it looks empty", "needs something visual", "looks boring" |
|
|
486
|
+
| Design ask | "design a logo", "make it look good", "something for the homepage" |
|
|
522
487
|
|
|
523
|
-
Platform routing
|
|
524
|
-
- Google Antigravity → Gemini Imagen 3 (native, no key needed)
|
|
525
|
-
- Codex CLI → DALL-E 3 (native, no key needed)
|
|
526
|
-
- Claude Code → fal.ai MCP → SVG fallback
|
|
527
|
-
- Windsurf / Cursor → native model image gen → fal.ai → SVG fallback
|
|
528
|
-
- Any platform → SVG (always available, always free)
|
|
488
|
+
Platform routing: Antigravity → Gemini Imagen 3 · Codex → DALL-E 3 · Claude Code → fal.ai → SVG · others → SVG.
|
|
529
489
|
|
|
530
490
|
---
|
|
531
491
|
|
|
532
492
|
### `/project-launch` — New project parallel founding team
|
|
533
493
|
|
|
534
|
-
Trigger when
|
|
494
|
+
Trigger when starting something new of meaningful scope.
|
|
535
495
|
|
|
536
|
-
| Signal |
|
|
496
|
+
| Signal | Examples |
|
|
537
497
|
|---|---|
|
|
538
|
-
| New build | "help me build X", "I want to build X", "I'm building X", "
|
|
539
|
-
| Greenfield | "starting from scratch", "new project", "new app", "new service", "new API"
|
|
540
|
-
| Idea phase | "I have this idea", "I
|
|
541
|
-
|
|
|
542
|
-
| Product description | User describes a product they haven't started yet — what it does, who uses it |
|
|
543
|
-
| New SaaS / startup | "I'm building a SaaS", "side project", "startup idea", "I want to launch" |
|
|
544
|
-
| Multi-component new thing | "an app that does X, Y, and Z" — multiple features described together |
|
|
498
|
+
| New build | "help me build X", "I want to build X", "I'm building X", "let's make X" |
|
|
499
|
+
| Greenfield | "starting from scratch", "new project", "new app", "new service", "new API" |
|
|
500
|
+
| Idea phase | "I have this idea", "I'm thinking of building", "I want to make a" |
|
|
501
|
+
| New SaaS / startup | "I'm building a SaaS", "side project", "startup idea" |
|
|
545
502
|
|
|
546
|
-
**Key rule:**
|
|
503
|
+
**Key rule:** Non-trivial new build → `/project-launch`. Adding one feature to existing codebase → `pair-programmer`.
|
|
547
504
|
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
Route to `/project-launch` — fires `architect` + `pair-programmer` + `security-reviewer` + `tdd-guide` + `ux-reviewer` simultaneously. Parallel analysis: 10 min instead of 45 min.
|
|
505
|
+
Route to `/project-launch` — fires `architect` + `pair-programmer` + `security-reviewer` + `tdd-guide` + `ux-reviewer` simultaneously.
|
|
551
506
|
|
|
552
507
|
---
|
|
553
508
|
|
|
554
509
|
### `/team-review` — Existing project parallel full audit
|
|
555
510
|
|
|
556
|
-
Trigger when
|
|
511
|
+
Trigger when review scope is broad (multiple files) or the user asks "is this ready?".
|
|
557
512
|
|
|
558
|
-
| Signal |
|
|
513
|
+
| Signal | Examples |
|
|
559
514
|
|---|---|
|
|
560
|
-
|
|
|
561
|
-
|
|
|
562
|
-
|
|
|
563
|
-
| Quality check | "is my code good?", "what's wrong with my project?", "code quality check", "is this production-ready?" |
|
|
564
|
-
| Multiple concerns | User mentions security AND performance AND quality — parallel review is the right answer |
|
|
565
|
-
| Readiness check | "is this ready?", "should I launch?", "any issues before I ship?", "what am I missing?" |
|
|
515
|
+
| Broad review | "review my project", "check my codebase", "audit my code" |
|
|
516
|
+
| Pre-release | "before I ship", "ready to release?", "pre-launch check", "about to go live" |
|
|
517
|
+
| Readiness check | "is this ready?", "any issues before I ship?", "is this production-ready?" |
|
|
566
518
|
|
|
567
|
-
**Key rule:** Single-file review → language-specific reviewer
|
|
519
|
+
**Key rule:** Single-file review → language-specific reviewer. Full project or multi-file → `/team-review`.
|
|
568
520
|
|
|
569
|
-
Route to `/team-review` — fires `code-reviewer` + `security-reviewer` + `performance-optimizer` + `api-guardian` simultaneously.
|
|
521
|
+
Route to `/team-review` — fires `code-reviewer` + `security-reviewer` + `performance-optimizer` + `api-guardian` simultaneously.
|
|
570
522
|
|
|
571
523
|
---
|
|
572
524
|
|
|
573
525
|
### `/security-audit` — Full parallel security sweep
|
|
574
526
|
|
|
575
|
-
Trigger when
|
|
527
|
+
Trigger when security concern spans the whole project or multiple vectors (secrets + deps + API).
|
|
576
528
|
|
|
577
|
-
| Signal |
|
|
529
|
+
| Signal | Examples |
|
|
578
530
|
|---|---|
|
|
579
|
-
| Full security concern | "is my app secure?", "security audit", "
|
|
580
|
-
| Pre-launch security | "before I go public", "about to expose this API"
|
|
531
|
+
| Full security concern | "is my app secure?", "security audit", "run a security check" |
|
|
532
|
+
| Pre-launch security | "before I go public", "about to expose this API" |
|
|
581
533
|
| Dependency worry | "are my deps safe?", "any vulnerable packages?", "CVEs in my dependencies?" |
|
|
582
|
-
| Auth concern | "is my auth secure?", "is my login safe?", "JWT/OAuth/session security" combined with dep or API mention |
|
|
583
|
-
| Multiple security angles | User mentions secrets AND API keys AND dependencies together — all three need sweeping |
|
|
584
|
-
|
|
585
|
-
**Key rule:** Single security concern on one file → `security-reviewer`. Full project sweep or multiple security vectors at once → `/security-audit`.
|
|
586
534
|
|
|
587
|
-
**
|
|
535
|
+
**Key rule:** Single file concern → `security-reviewer`. Multi-vector or project-wide → `/security-audit`.
|
|
588
536
|
|
|
589
537
|
Route to `/security-audit` — fires `security-reviewer` + `dependency-doctor` + `api-guardian` simultaneously.
|
|
590
538
|
|
|
@@ -592,38 +540,32 @@ Route to `/security-audit` — fires `security-reviewer` + `dependency-doctor` +
|
|
|
592
540
|
|
|
593
541
|
### `/devil-mode` — Full adversarial parallel sweep
|
|
594
542
|
|
|
595
|
-
Trigger when
|
|
543
|
+
Trigger when attacker mindset is needed across the whole codebase, especially pre-public or post-compromise.
|
|
596
544
|
|
|
597
|
-
| Signal |
|
|
545
|
+
| Signal | Examples |
|
|
598
546
|
|---|---|
|
|
599
|
-
| Attacker mindset | "think like an attacker", "
|
|
600
|
-
| Pre-public sweep | "
|
|
601
|
-
|
|
|
602
|
-
|
|
|
603
|
-
| Pre-launch paranoia | "launching tomorrow, find everything", "find what we missed", "what's the worst case in my code?" |
|
|
604
|
-
| Devil mode keyword | "devil mode", "go feral on this", "throw everything at it", "no-mercy audit", "paranoid review" |
|
|
605
|
-
|
|
606
|
-
**Key rule:** Standard security concern with one or two angles → `/security-audit`. Multi-vector adversarial sweep, going public, or attacker-mindset framing → `/devil-mode`.
|
|
547
|
+
| Attacker mindset | "think like an attacker", "red-team my code", "find what's exploitable" |
|
|
548
|
+
| Pre-public sweep | "going open-source — full audit", "scan for everything before I publish" |
|
|
549
|
+
| Post-compromise | "we were hacked, audit everything", "after the incident, full review" |
|
|
550
|
+
| Devil mode keyword | "devil mode", "no-mercy audit", "paranoid review" |
|
|
607
551
|
|
|
608
|
-
**
|
|
552
|
+
**Key rule:** One or two security angles → `/security-audit`. Multi-vector attacker sweep → `/devil-mode`.
|
|
609
553
|
|
|
610
|
-
Route to `/devil-mode` — fires `prompt-injection-hunter` + `supply-chain-auditor` + `secret-hunter` + `backdoor-hunter
|
|
554
|
+
Route to `/devil-mode` — fires `prompt-injection-hunter` + `supply-chain-auditor` + `secret-hunter` + `backdoor-hunter`. Use `--all` for all 8, `--pre-public` for OSS sweep, `--pre-launch` for launch sweep.
|
|
611
555
|
|
|
612
556
|
---
|
|
613
557
|
|
|
614
558
|
### `/pre-release` — Ship-readiness parallel check
|
|
615
559
|
|
|
616
|
-
Trigger when
|
|
560
|
+
Trigger when cutting a release, tagging a version, or deploying to production.
|
|
617
561
|
|
|
618
|
-
| Signal |
|
|
562
|
+
| Signal | Examples |
|
|
619
563
|
|---|---|
|
|
620
|
-
| About to release | "ready to cut v2?", "
|
|
621
|
-
| Release checklist | "
|
|
622
|
-
|
|
|
623
|
-
| Final sanity check | "last check before I push to prod", "final review before release", "one more look before shipping" |
|
|
624
|
-
| Combined signals | User mentions semver + "ready" or "deploy" + "safe" together |
|
|
564
|
+
| About to release | "ready to cut v2?", "cutting a release", "tagging v1.0", "shipping today" |
|
|
565
|
+
| Release checklist | "release checklist", "anything missing before v2?" |
|
|
566
|
+
| Final sanity check | "last check before I push to prod", "one more look before shipping" |
|
|
625
567
|
|
|
626
|
-
**Key rule:** General
|
|
568
|
+
**Key rule:** General readiness → `/team-review`. Explicit release or version cut → `/pre-release`.
|
|
627
569
|
|
|
628
570
|
Route to `/pre-release` — fires `release-captain` + `security-reviewer` + `code-reviewer` simultaneously.
|
|
629
571
|
|
|
@@ -631,17 +573,15 @@ Route to `/pre-release` — fires `release-captain` + `security-reviewer` + `cod
|
|
|
631
573
|
|
|
632
574
|
### `/debug-blitz` — Triple-agent parallel debug for stubborn bugs
|
|
633
575
|
|
|
634
|
-
Trigger when a bug has resisted normal debugging
|
|
576
|
+
Trigger when a bug has resisted normal debugging or spans multiple layers (code + env + hidden failure).
|
|
635
577
|
|
|
636
|
-
| Signal |
|
|
578
|
+
| Signal | Examples |
|
|
637
579
|
|---|---|
|
|
638
|
-
| Persistent bug | "
|
|
639
|
-
| Multi-layer problem | "works locally not in CI", "works on my machine", "only fails in prod"
|
|
640
|
-
|
|
|
641
|
-
| Environment suspicion | "is it my env?", "could it be a config issue?", "not sure if it's the code or environment" |
|
|
642
|
-
| Frustration signal | "I give up", "losing my mind", "this is driving me crazy", "been stuck for X hours/days" |
|
|
580
|
+
| Persistent bug | "been fighting this for hours", "nothing is working", "tried everything" |
|
|
581
|
+
| Multi-layer problem | "works locally not in CI", "works on my machine", "only fails in prod" |
|
|
582
|
+
| Frustration signal | "I give up", "losing my mind", "been stuck for X hours/days" |
|
|
643
583
|
|
|
644
|
-
**Key rule:** First-time bug
|
|
584
|
+
**Key rule:** First-time bug → `debug-detective`. Persistent, multi-layer, or frustration-coded → `/debug-blitz`.
|
|
645
585
|
|
|
646
586
|
Route to `/debug-blitz` — fires `debug-detective` + `silent-failure-hunter` + `env-debugger` simultaneously.
|
|
647
587
|
|
|
@@ -649,17 +589,14 @@ Route to `/debug-blitz` — fires `debug-detective` + `silent-failure-hunter` +
|
|
|
649
589
|
|
|
650
590
|
### `/refactor-sprint` — Full parallel refactor + type + test pass
|
|
651
591
|
|
|
652
|
-
Trigger when
|
|
592
|
+
Trigger when cleanup spans a module or file, especially when multiple concerns (readability + types + tests) come together.
|
|
653
593
|
|
|
654
|
-
| Signal |
|
|
594
|
+
| Signal | Examples |
|
|
655
595
|
|---|---|
|
|
656
|
-
| Big cleanup | "refactor this module", "
|
|
657
|
-
| Multi-concern quality | "improve quality, types, and add tests", "
|
|
658
|
-
| Code health | "code is getting hard to maintain", "too much complexity", "needs a full cleanup", "legacy code overhaul" |
|
|
659
|
-
| Combined refactor | "refactor + add types + write tests" — three concerns together always means blitz |
|
|
660
|
-
| Pre-hire prep | "cleaning up before the new dev joins", "making this more readable for the team" |
|
|
596
|
+
| Big cleanup | "refactor this module", "this code is a mess", "technical debt cleanup" |
|
|
597
|
+
| Multi-concern quality | "improve quality, types, and add tests", "full cleanup", "legacy code overhaul" |
|
|
661
598
|
|
|
662
|
-
**Key rule:**
|
|
599
|
+
**Key rule:** Single function cleanup → `refactor-cleaner`. Module-wide with types and tests → `/refactor-sprint`.
|
|
663
600
|
|
|
664
601
|
Route to `/refactor-sprint` — fires `refactor-cleaner` + `code-simplifier` + `type-design-analyzer` + `tdd-guide` simultaneously.
|
|
665
602
|
|
|
@@ -667,17 +604,15 @@ Route to `/refactor-sprint` — fires `refactor-cleaner` + `code-simplifier` + `
|
|
|
667
604
|
|
|
668
605
|
### `/onboard` — New-joiner parallel codebase onboarding
|
|
669
606
|
|
|
670
|
-
Trigger when someone is new to a codebase and needs to understand it
|
|
607
|
+
Trigger when someone is new to a codebase and needs to understand it.
|
|
671
608
|
|
|
672
|
-
| Signal |
|
|
609
|
+
| Signal | Examples |
|
|
673
610
|
|---|---|
|
|
674
|
-
| New to codebase | "I just joined the team", "
|
|
675
|
-
| Explore unfamiliar code | "never seen this code before", "
|
|
676
|
-
|
|
|
677
|
-
| Architecture understanding | "what does this system do?", "explain the architecture to me", "how does all of this fit together?" |
|
|
678
|
-
| Ramp-up request | "help me get up to speed", "ramp me up on this", "what should I know about this codebase?" |
|
|
611
|
+
| New to codebase | "I just joined the team", "inherited this codebase", "taking over this repo" |
|
|
612
|
+
| Explore unfamiliar code | "never seen this code before", "where do I even start?" |
|
|
613
|
+
| Ramp-up request | "help me get up to speed", "ramp me up on this" |
|
|
679
614
|
|
|
680
|
-
**Key rule:** Single "explain this function" → `code-explorer`. Full codebase orientation
|
|
615
|
+
**Key rule:** Single "explain this function" → `code-explorer`. Full codebase orientation → `/onboard`.
|
|
681
616
|
|
|
682
617
|
Route to `/onboard` — fires `code-explorer` + `architect` + `doc-updater` simultaneously.
|
|
683
618
|
|
|
@@ -685,30 +620,27 @@ Route to `/onboard` — fires `code-explorer` + `architect` + `doc-updater` simu
|
|
|
685
620
|
|
|
686
621
|
### `/lessons` — Project lessons management
|
|
687
622
|
|
|
688
|
-
Trigger when the user references project rules, preferences, corrections, or past instructions.
|
|
623
|
+
Trigger when the user references project rules, preferences, corrections, or past instructions.
|
|
689
624
|
|
|
690
|
-
| Signal |
|
|
625
|
+
| Signal | Examples |
|
|
691
626
|
|---|---|
|
|
692
|
-
| Load rules | "load my lessons", "what rules do we have", "
|
|
693
|
-
| Remember something | "remember that we use pnpm", "
|
|
694
|
-
| Preference | "I prefer X", "we always do X here", "never do Y in this project", "always use X not Y" |
|
|
695
|
-
| Save corrections | "save what I told you today", "write that down", "remember this for next time", "add this to the rules" |
|
|
627
|
+
| Load rules | "load my lessons", "what rules do we have", "show me the rules" |
|
|
628
|
+
| Remember something | "remember that we use pnpm", "note that we do X", "don't forget Y" |
|
|
696
629
|
| Habit encode | "from now on always X", "make it a rule that", "I want you to always" |
|
|
697
|
-
|
|
630
|
+
|
|
631
|
+
Proactively offer to load if `tasks/lessons.md` exists in the project root.
|
|
698
632
|
|
|
699
633
|
---
|
|
700
634
|
|
|
701
635
|
### Parallel suggestions
|
|
702
636
|
|
|
703
|
-
When the user's request spans multiple concerns, name the parallel agents
|
|
637
|
+
When the user's request spans multiple concerns, name the parallel agents:
|
|
704
638
|
|
|
705
639
|
- "I'm building a payment endpoint" → `pair-programmer` + `security-reviewer` + `api-guardian`
|
|
706
640
|
- "Refactoring the auth module" → `refactor-cleaner` + `security-reviewer` + `tdd-guide`
|
|
707
|
-
- "help me build a SaaS app" → `/project-launch` (5 agents
|
|
708
|
-
- "review my project before I deploy" → `/team-review` (4 agents
|
|
641
|
+
- "help me build a SaaS app" → `/project-launch` (5 agents)
|
|
642
|
+
- "review my project before I deploy" → `/team-review` (4 agents)
|
|
709
643
|
- "my site needs visuals" → `image-architect`
|
|
710
|
-
- "new feature that touches the API" → `pair-programmer` + `api-guardian` + `security-reviewer`
|
|
711
|
-
- "big refactor of core module" → `architect` + `refactor-cleaner` + `tdd-guide`
|
|
712
644
|
|
|
713
645
|
---
|
|
714
646
|
|
|
@@ -717,11 +649,10 @@ When the user's request spans multiple concerns, name the parallel agents and ex
|
|
|
717
649
|
**Skip routing if:**
|
|
718
650
|
|
|
719
651
|
- The user **already explicitly invoked** an agent (`use <agent>`, `@agent`, `invoke <agent>`) — that takes precedence
|
|
720
|
-
- The message is **a one-liner factual question**
|
|
721
|
-
- The message is **purely conversational** ("hi", "thanks", "ok"
|
|
652
|
+
- The message is **a one-liner factual question** — answer directly
|
|
653
|
+
- The message is **purely conversational** ("hi", "thanks", "ok") — respond normally
|
|
722
654
|
- The user says **"just answer me directly"** or **"don't route"** — respect it
|
|
723
|
-
- The
|
|
724
|
-
- The request is **trivially simple** (rename a variable, change one line, answer a "what is X?" question)
|
|
655
|
+
- The request is **trivially simple** (rename a variable, change one line)
|
|
725
656
|
|
|
726
657
|
---
|
|
727
658
|
|
|
@@ -737,59 +668,29 @@ When the user's request spans multiple concerns, name the parallel agents and ex
|
|
|
737
668
|
| "How do I make this faster?" | `performance-optimizer` | Direct perf question |
|
|
738
669
|
| "Is my JWT signing secure?" | `security-reviewer` | Auth + security keyword |
|
|
739
670
|
| "build failed on Vercel" | `build-error-resolver` | Build failure |
|
|
740
|
-
| "Tests are slow / red" | `tdd-guide` then `debug-detective` | Test-first reasoning |
|
|
741
671
|
| "Migrate from Pages Router to App Router" | `migration-guide` | Framework migration |
|
|
742
672
|
| "Add accessibility to this form" | `ux-reviewer` | a11y |
|
|
743
|
-
| "Plan the v2 redesign" | `planner` → `architect` | Plan + design |
|
|
744
|
-
| "open source this project" | `opensource-forker` | OSS chain start |
|
|
745
673
|
| "production is down, getting 500s" | `incident-commander` | Active production incident |
|
|
746
674
|
| "will this hold under 10k users?" | `load-tester` | Capacity question |
|
|
747
|
-
| "postmortem for yesterday's outage" | `incident-commander` | Postmortem workflow |
|
|
748
675
|
| "generate a hero image" | `image-architect` | Explicit image request |
|
|
749
|
-
| "my site looks plain
|
|
750
|
-
| "
|
|
751
|
-
| "help me build a todo app" | `/project-launch` | New build — founding team |
|
|
752
|
-
| "I want to create a REST API from scratch" | `/project-launch` | New build |
|
|
676
|
+
| "my site looks plain" | `image-architect` | Implicit visual need |
|
|
677
|
+
| "help me build a todo app" | `/project-launch` | New build |
|
|
753
678
|
| "I have this idea for a SaaS dashboard" | `/project-launch` | Greenfield project |
|
|
754
|
-
| "I'm starting a new side project" | `/project-launch` | New project |
|
|
755
|
-
| "can you review my code?" | `code-reviewer` or `/team-review` | Narrow → reviewer, broad → team |
|
|
756
679
|
| "review my code before I deploy" | `/team-review` | Pre-release, full scope |
|
|
757
|
-
| "is my project ready to ship?" | `/team-review` | Readiness check |
|
|
758
|
-
| "full audit before we release v2" | `/team-review` | Explicit full audit |
|
|
759
680
|
| "is my app secure? check everything" | `/security-audit` | Full security sweep |
|
|
760
|
-
| "any CVEs in my deps?" | `/security-audit` | Dependency + security combo |
|
|
761
681
|
| "cutting v2 today, last check" | `/pre-release` | Release + confidence combo |
|
|
762
|
-
| "
|
|
763
|
-
| "been stuck on this bug for 2 days" | `/debug-blitz` | Persistent frustration = blitz |
|
|
682
|
+
| "been stuck on this bug for 2 days" | `/debug-blitz` | Persistent frustration |
|
|
764
683
|
| "works locally not in prod" | `/debug-blitz` | Multi-layer problem |
|
|
765
684
|
| "clean up this whole module, add types and tests" | `/refactor-sprint` | Multi-concern quality |
|
|
766
|
-
| "this code is a mess, full cleanup needed" | `/refactor-sprint` | Technical debt + scope |
|
|
767
685
|
| "I just joined this team, where do I start?" | `/onboard` | New-joiner onboarding |
|
|
768
686
|
| "think like an attacker, sweep my code" | `/devil-mode` | Attacker mindset trigger |
|
|
769
|
-
| "going open-source, full audit before publish" | `/devil-mode --pre-public` | Pre-public
|
|
687
|
+
| "going open-source, full audit before publish" | `/devil-mode --pre-public` | Pre-public sweep |
|
|
770
688
|
| "we were hacked, audit everything" | `/devil-mode --all` | Post-compromise full sweep |
|
|
771
689
|
| "is my AI feature jailbreak-safe?" | `prompt-injection-hunter` | AI-feature attack surface |
|
|
772
690
|
| "did I leak secrets in git history?" | `secret-hunter` | Credential leak hunt |
|
|
773
|
-
| "could this npm package be malicious?" | `supply-chain-auditor` | Dep paranoia |
|
|
774
|
-
| "audit my deps for GPL contamination" | `license-violation-finder` | Copyleft check |
|
|
775
|
-
| "is this code copy-pasted from somewhere?" | `code-stealer-detector` | Provenance audit |
|
|
776
|
-
| "scan this vendored lib for backdoors" | `backdoor-hunter` | Malicious-code scan |
|
|
777
|
-
| "red-team my chatbot for jailbreaks" | `jailbreak-tester` | Live AI red-team |
|
|
778
|
-
| "what hidden assumptions could break us?" | `chaos-engineer` | Fault-injection planning |
|
|
779
|
-
| "inherited this codebase, help me understand it" | `/onboard` | Unfamiliar codebase |
|
|
780
691
|
| "remember we always use pnpm here" | `/lessons` | Preference to encode |
|
|
781
|
-
| "what rules do we follow in this project?" | `/lessons` | Load lessons |
|
|
782
|
-
| "from now on never use var" | `/lessons` | Rule to save |
|
|
783
692
|
| [user pastes code with no text] | `code-reviewer` | Implicit review |
|
|
784
693
|
| [user pastes stack trace with no text] | `debug-detective` | Implicit debug |
|
|
785
|
-
| "open the dashboard" | `/dashboard` | Local observability UI |
|
|
786
|
-
| "show me what's in my memory store" | `/dashboard` | Memory inspection |
|
|
787
|
-
| "run a swarm on this task" | `/swarm` | Parallel agent execution |
|
|
788
|
-
| "which model should I use for this?" | `/route-model` | Cost-aware model routing |
|
|
789
|
-
| "what has ECC learned from my usage?" | `/memory-evolve` | Evolve proposals review |
|
|
790
|
-
| "replay that session bundle" | `/replay` | Session reproduction |
|
|
791
|
-
| "show evolve proposals" | `/memory-evolve` | Pending skill/routing proposals |
|
|
792
|
-
| "fastest way to run this across agents" | `/swarm` | Maximum-throughput execution |
|
|
793
694
|
|
|
794
695
|
---
|
|
795
696
|
|
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: Bug report
|
|
3
|
-
about: Something broken in ECC — install failure, agent misbehavior, hook error
|
|
4
|
-
title: '[BUG] '
|
|
5
|
-
labels: bug
|
|
6
|
-
assignees: ''
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## What happened
|
|
10
|
-
|
|
11
|
-
<!-- Describe what went wrong. Include the exact command you ran or behavior you observed. -->
|
|
12
|
-
|
|
13
|
-
## Expected behavior
|
|
14
|
-
|
|
15
|
-
<!-- What should have happened instead. -->
|
|
16
|
-
|
|
17
|
-
## Steps to reproduce
|
|
18
|
-
|
|
19
|
-
1.
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
22
|
-
|
|
23
|
-
## Environment
|
|
24
|
-
|
|
25
|
-
- **ECC version**: <!-- run: cat ~/.claude/kodelyth-ecc-install-state.json | grep version -->
|
|
26
|
-
- **Install target**: <!-- claude-home / windsurf-home / windsurf-project / cursor-project / codex-home / antigravity / opencode -->
|
|
27
|
-
- **Platform**: <!-- macOS / Linux / Windows -->
|
|
28
|
-
- **AI IDE**: <!-- Claude Code / Windsurf / Cursor / Codex CLI / Antigravity / OpenCode -->
|
|
29
|
-
- **Node.js version**: <!-- run: node --version -->
|
|
30
|
-
|
|
31
|
-
## Doctor output
|
|
32
|
-
|
|
33
|
-
<!-- Run: node scripts/doctor.js or /doctor in your IDE -->
|
|
34
|
-
|
|
35
|
-
```
|
|
36
|
-
paste output here
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## Relevant logs or error messages
|
|
40
|
-
|
|
41
|
-
```
|
|
42
|
-
paste here
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
## Additional context
|
|
46
|
-
|
|
47
|
-
<!-- Screenshots, related issues, anything else. -->
|
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
blank_issues_enabled: false
|
|
2
|
-
contact_links:
|
|
3
|
-
- name: Ask a question / discuss
|
|
4
|
-
url: https://github.com/sifxprime/kodelyth-ecc/discussions
|
|
5
|
-
about: Use GitHub Discussions for questions, show & tell, and ideas.
|
|
6
|
-
- name: Read the docs
|
|
7
|
-
url: https://github.com/sifxprime/kodelyth-ecc/wiki
|
|
8
|
-
about: Check the wiki first — FAQ, installation guide, agent reference.
|
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: Feature request
|
|
3
|
-
about: Suggest a new agent, skill, command, hook, platform, or bundle
|
|
4
|
-
title: '[FEATURE] '
|
|
5
|
-
labels: enhancement
|
|
6
|
-
assignees: ''
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## What are you proposing?
|
|
10
|
-
|
|
11
|
-
<!-- One clear sentence. e.g. "Add a `database-migrator` agent" or "Support Neovim as an install target" -->
|
|
12
|
-
|
|
13
|
-
## Problem it solves
|
|
14
|
-
|
|
15
|
-
<!-- What pain does this remove? What do users have to do manually today? -->
|
|
16
|
-
|
|
17
|
-
## Proposed solution
|
|
18
|
-
|
|
19
|
-
<!-- How should it work? Be as specific as you can. -->
|
|
20
|
-
|
|
21
|
-
## Alternatives you've considered
|
|
22
|
-
|
|
23
|
-
<!-- What did you try or think about before proposing this? -->
|
|
24
|
-
|
|
25
|
-
## Category
|
|
26
|
-
|
|
27
|
-
- [ ] New agent
|
|
28
|
-
- [ ] New skill
|
|
29
|
-
- [ ] New slash command
|
|
30
|
-
- [ ] New hook
|
|
31
|
-
- [ ] New platform / install target
|
|
32
|
-
- [ ] New bundle
|
|
33
|
-
- [ ] Dashboard feature
|
|
34
|
-
- [ ] MCP server feature
|
|
35
|
-
- [ ] Other: ___
|
|
36
|
-
|
|
37
|
-
## Would you be willing to contribute it?
|
|
38
|
-
|
|
39
|
-
- [ ] Yes — I can open a PR
|
|
40
|
-
- [ ] No — but I'd test it
|
|
41
|
-
- [ ] Not sure yet
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: Good first issue
|
|
3
|
-
about: Something small and well-scoped — perfect for a first contribution
|
|
4
|
-
title: '[GOOD FIRST ISSUE] '
|
|
5
|
-
labels: good first issue, help wanted
|
|
6
|
-
assignees: ''
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## What needs to be done
|
|
10
|
-
|
|
11
|
-
<!-- Clear, one-paragraph description of the task. No ambiguity. -->
|
|
12
|
-
|
|
13
|
-
## Why it matters
|
|
14
|
-
|
|
15
|
-
<!-- One sentence. What does this fix or improve for users? -->
|
|
16
|
-
|
|
17
|
-
## Exact acceptance criteria
|
|
18
|
-
|
|
19
|
-
- [ ] ...
|
|
20
|
-
- [ ] ...
|
|
21
|
-
- [ ] `npm test` passes
|
|
22
|
-
|
|
23
|
-
## Helpful context
|
|
24
|
-
|
|
25
|
-
<!-- Links to relevant files, docs, or examples. -->
|
|
26
|
-
|
|
27
|
-
- Related file(s): `...`
|
|
28
|
-
- Related docs: `...`
|
|
29
|
-
|
|
30
|
-
## Estimated effort
|
|
31
|
-
|
|
32
|
-
<!-- XS (< 1h) / S (1-2h) / M (2-4h) -->
|
|
33
|
-
|
|
34
|
-
## Questions?
|
|
35
|
-
|
|
36
|
-
Drop a comment before starting. We'll clarify anything that's unclear.
|