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.
Files changed (91) hide show
  1. package/CLAUDE.md +1 -1
  2. package/VERSION +1 -1
  3. package/bin/kodelyth-ecc.js +54 -5
  4. package/install.ps1 +30 -13
  5. package/install.sh +11 -4
  6. package/package.json +1 -1
  7. package/rules/common/agent-intent-routing.md +96 -195
  8. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -47
  9. package/.github/ISSUE_TEMPLATE/config.yml +0 -8
  10. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -41
  11. package/.github/ISSUE_TEMPLATE/good_first_issue.md +0 -36
  12. package/.github/ISSUE_TEMPLATE/new_agent.md +0 -52
  13. package/.github/PULL_REQUEST_TEMPLATE.md +0 -53
  14. package/.github/workflows/ci.yml +0 -45
  15. package/.github/workflows/publish.yml +0 -60
  16. package/brand/concepts.svg +0 -109
  17. package/brand/convert.js +0 -161
  18. package/brand/favicon.svg +0 -7
  19. package/brand/fb-cover.svg +0 -34
  20. package/brand/fb-profile.svg +0 -21
  21. package/brand/kodelyth-dark.svg +0 -24
  22. package/brand/kodelyth-light.svg +0 -24
  23. package/brand/kodelyth-mark.svg +0 -20
  24. package/brand/package.json +0 -12
  25. package/docs/dashboard.md +0 -211
  26. package/docs/evolve.md +0 -303
  27. package/docs/mcp-clients.md +0 -167
  28. package/docs/mcp.md +0 -178
  29. package/docs/replay.md +0 -244
  30. package/docs/supply-chain.md +0 -207
  31. package/docs/swarm.md +0 -243
  32. package/skills/skill-comply/tests/test_grader.py +0 -137
  33. package/skills/skill-comply/tests/test_parser.py +0 -90
  34. package/social/card-agents.svg +0 -104
  35. package/social/card-install.svg +0 -58
  36. package/social/card-main.svg +0 -54
  37. package/social/facebook-v150.svg +0 -110
  38. package/social/fb-ad-main.svg +0 -128
  39. package/social/fb-post-features.svg +0 -118
  40. package/social/fb-post-launch.svg +0 -144
  41. package/social/fb-post-platforms.svg +0 -135
  42. package/social/github-social-preview.svg +0 -151
  43. package/social/hype-compound-learning.svg +0 -129
  44. package/social/hype-devil-mode.svg +0 -240
  45. package/social/hype-mcp-server.svg +0 -148
  46. package/social/hype-parallel-agents.svg +0 -162
  47. package/social/hype-stats-hero.svg +0 -138
  48. package/social/og-image.svg +0 -151
  49. package/social/readme-agents.svg +0 -138
  50. package/social/readme-hero.svg +0 -102
  51. package/social/section-agents.svg +0 -69
  52. package/social/section-author.svg +0 -66
  53. package/social/section-dashboard.svg +0 -71
  54. package/social/section-devil.svg +0 -66
  55. package/social/section-hooks.svg +0 -63
  56. package/social/section-install.svg +0 -54
  57. package/social/section-learning.svg +0 -64
  58. package/social/section-mcp.svg +0 -58
  59. package/social/section-memory.svg +0 -69
  60. package/social/section-parallel.svg +0 -84
  61. package/social/section-routing.svg +0 -63
  62. package/social/twitter-threads.md +0 -621
  63. package/social/x-card-agents-grid.svg +0 -120
  64. package/social/x-card-free.svg +0 -71
  65. package/social/x-card-hook.svg +0 -94
  66. package/tests/dashboard/data.test.js +0 -391
  67. package/tests/dashboard/server.test.js +0 -257
  68. package/tests/evolve/analyze.test.js +0 -169
  69. package/tests/evolve/proposals.test.js +0 -173
  70. package/tests/evolve/stats.test.js +0 -167
  71. package/tests/hooks/branch-name-check.test.js +0 -184
  72. package/tests/hooks/smart-suggest.test.js +0 -149
  73. package/tests/hooks/test-reminder.test.js +0 -181
  74. package/tests/mcp/catalog.test.js +0 -98
  75. package/tests/mcp/client.test.js +0 -113
  76. package/tests/mcp/resources-prompts.test.js +0 -70
  77. package/tests/mcp/tools.test.js +0 -159
  78. package/tests/memory/auto-recall.test.js +0 -132
  79. package/tests/memory/instincts.test.js +0 -258
  80. package/tests/memory/store.test.js +0 -203
  81. package/tests/replay/bundle.test.js +0 -181
  82. package/tests/replay/replay.test.js +0 -131
  83. package/tests/router/classify.test.js +0 -164
  84. package/tests/run-all.js +0 -55
  85. package/tests/safety/patterns.test.js +0 -94
  86. package/tests/safety/prompt-injection-guard.test.js +0 -111
  87. package/tests/safety/token-budget.test.js +0 -119
  88. package/tests/supply-chain/manifest.test.js +0 -147
  89. package/tests/supply-chain/sbom.test.js +0 -170
  90. package/tests/supply-chain/verify.test.js +0 -146
  91. 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 | Real human phrasing |
404
+ | Signal | Examples |
405
405
  |---|---|
406
- | Communication | "draft an email", "write a message", "reply to this", "how should I say this", "slack message" |
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 | Real human phrasing |
411
+ | Signal | Examples |
412
412
  |---|---|
413
- | SEO | "SEO", "meta tags", "schema.org", "structured data", "Core Web Vitals", "sitemap", "my page doesn't rank", "Google isn't indexing" |
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 | Real human phrasing |
417
+ | Signal | Examples |
418
418
  |---|---|
419
- | OSS prep | "open source this", "make this public", "publish to GitHub", "strip secrets", "remove credentials", "I want to release this as open source" |
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
- Trigger when the user wants to inspect ECC's live data — memory store, session history, agent catalog, token budget, or evolve proposals — through a browser UI.
426
-
427
- | Signal | Real human phrasing |
425
+ | Signal | Examples |
428
426
  |---|---|
429
- | Open dashboard | "open the dashboard", "launch the dashboard", "show me the dashboard", "start the dashboard" |
430
- | Inspect memory | "show me what's in my memory", "browse my sessions", "see my memory store", "view past solutions" |
431
- | View catalog | "show me the agent catalog", "list my agents in the UI", "see all skills in a browser" |
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
- Trigger when the user wants to run a task across multiple parallel agents simultaneously, each in an isolated git worktree — the maximum-throughput execution mode.
440
-
441
- | Signal | Real human phrasing |
433
+ | Signal | Examples |
442
434
  |---|---|
443
- | Swarm request | "use the swarm", "run a swarm", "swarm this", "parallel swarm on this task", "launch swarm" |
444
- | Parallel worktrees | "run agents in parallel", "use git worktrees", "spawn multiple agents at once", "parallel execution" |
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
- Trigger when the user is unsure which model tier to use for a task, wants to minimize cost, or is asking about the right model for a specific job.
453
-
454
- | Signal | Real human phrasing |
440
+ | Signal | Examples |
455
441
  |---|---|
456
- | Model choice | "which model should I use", "what model for this task", "haiku or sonnet?", "should I use opus here" |
457
- | Cost concern | "cheapest model for this", "save tokens on this", "what's the cost-efficient choice", "not worth opus" |
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
- Trigger when the user wants to see what patterns ECC has learned from their usage and review proposals for new skills or routing rules derived from that data.
466
-
467
- | Signal | Real human phrasing |
447
+ | Signal | Examples |
468
448
  |---|---|
469
- | Evolve proposals | "show evolve proposals", "what has ECC learned", "memory evolution", "evolve my toolkit" |
470
- | Skill upgrades | "suggest new skills from usage", "what skills should I add", "my memory patterns", "recurring solutions" |
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
- Trigger when the user wants to re-run or review a past session bundle — reproducing a past agent workflow exactly.
479
-
480
- | Signal | Real human phrasing |
454
+ | Signal | Examples |
481
455
  |---|---|
482
- | Replay request | "replay a session", "re-run that session", "session replay", "run the session bundle again" |
483
- | Review past work | "what happened in that session", "reproduce that workflow", "play back the session" |
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. Cast wide — users rarely say "generate"; they say "I need" or "add" or "make it look nice".
479
+ Trigger on ANY request for a visual, image, picture, graphic, or design asset.
511
480
 
512
- | Signal | Real human phrasing |
481
+ | Signal | Examples |
513
482
  |---|---|
514
- | Explicit request | "generate an image", "create a picture", "make a visual", "I need graphics", "make an illustration" |
515
- | Hero / banner | "hero image", "header image", "banner", "background image for my site", "the top image" |
516
- | Social assets | "OG image", "social preview", "GitHub card", "Twitter card", "Facebook image", "LinkedIn banner", "thumbnail for my post", "share image" |
517
- | Landing page | "images for my landing page", "visuals for the site", "add some images to my app", "make the landing page look good" |
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 inside `image-architect`:
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 someone is starting something new — ANY new build, app, service, or feature of meaningful scope. Do not wait for the user to say "launch" or "project-launch". If they are clearly at the start of building something non-trivial, this is always the right move.
494
+ Trigger when starting something new of meaningful scope.
535
495
 
536
- | Signal | Real human phrasing |
496
+ | Signal | Examples |
537
497
  |---|---|
538
- | New build | "help me build X", "I want to build X", "I'm building X", "I want to create X", "let's make X" |
539
- | Greenfield | "starting from scratch", "new project", "new app", "new service", "new API", "I'm starting a new" |
540
- | Idea phase | "I have this idea", "I want to create", "I'm thinking of building", "I want to make a" |
541
- | Planning start | "where do I start", "how should I approach building X", "what do I need to build X" |
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:** If the user describes a non-trivial new thing to build (more than a single function), default to `/project-launch`. Five expert agents analyzing simultaneously catches mistakes before they cost hours of rework. Always better to over-plan than under-plan.
503
+ **Key rule:** Non-trivial new build `/project-launch`. Adding one feature to existing codebase `pair-programmer`.
547
504
 
548
- **Counter-signals (do NOT route here):** User is adding one feature to an existing codebase → `pair-programmer`. User is describing an existing project to fix a bug → `debug-detective`.
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 someone wants their existing code reviewed and the scope is broad (more than one file), or when they're asking "is this ready?". Also trigger before any deployment, release, or launch of an existing project.
511
+ Trigger when review scope is broad (multiple files) or the user asks "is this ready?".
557
512
 
558
- | Signal | Real human phrasing |
513
+ | Signal | Examples |
559
514
  |---|---|
560
- | Review request (broad) | "review my code", "review my project", "check my codebase", "look at my code", "audit my code" |
561
- | Full audit | "audit everything", "full review", "review everything", "check the whole project", "go through my code" |
562
- | Pre-release | "before I ship", "ready to release?", "can I deploy this?", "pre-launch check", "about to go live" |
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 (e.g., `typescript-reviewer`). Full project or multi-file → `/team-review`. When in doubt about scope, ask.
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. Parallel review: 15 min instead of 60 min.
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 the user is worried about security across the whole project, not just one file. Also trigger before any public launch, API exposure, or when secrets/auth/dependencies are mentioned together.
527
+ Trigger when security concern spans the whole project or multiple vectors (secrets + deps + API).
576
528
 
577
- | Signal | Real human phrasing |
529
+ | Signal | Examples |
578
530
  |---|---|
579
- | Full security concern | "is my app secure?", "security audit", "check my security", "is there anything insecure?", "run a security check" |
580
- | Pre-launch security | "before I go public", "about to expose this API", "launching soon, any security issues?" |
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
- **Counter-signals (do NOT route here):** Single endpoint with a specific injection concern → `security-reviewer`. Dependency-only question`dependency-doctor`.
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 the user wants the **attacker mindset** applied to their entire codebase, not just one concern. Stronger than `/security-audit` — it hunts secrets, supply-chain attacks, prompt injection, and backdoors all at once. Always trigger before going open-source, before any public launch, after any security alert, or when the user mentions multiple adversarial concerns together.
543
+ Trigger when attacker mindset is needed across the whole codebase, especially pre-public or post-compromise.
596
544
 
597
- | Signal | Real human phrasing |
545
+ | Signal | Examples |
598
546
  |---|---|
599
- | Attacker mindset | "think like an attacker", "what would a hacker find?", "red-team my code", "adversarial review", "find what's exploitable" |
600
- | Pre-public sweep | "I'm going open-source — full audit", "making this public, scan for everything", "before I publish, full red-team" |
601
- | Multi-vector worry | User mentions secrets AND deps AND AI-feature security AND backdoors together |
602
- | Post-compromise | "we were hacked, audit everything", "compromise alert, sweep the codebase", "after the incident, full review" |
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
- **Counter-signals (do NOT route here):** Single-angle question (just secrets, just AI safety, just deps) individual devil-mode agent. Code quality (not adversarial) → `/team-review`.
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` simultaneously. Use `/devil-mode --all` to fire all 8 (also adds `license-violation-finder` + `code-stealer-detector` + `jailbreak-tester` + `chaos-engineer`). Use `/devil-mode --pre-public` for the open-source sweep, or `/devil-mode --pre-launch` for the launch readiness sweep.
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 the user is about to cut a release, tag a version, or deploy to production and wants confidence everything is correct. Also trigger when they mention "release" + "check" or "ready to ship" + version number.
560
+ Trigger when cutting a release, tagging a version, or deploying to production.
617
561
 
618
- | Signal | Real human phrasing |
562
+ | Signal | Examples |
619
563
  |---|---|
620
- | About to release | "ready to cut v2?", "about to release", "cutting a release", "tagging v1.0", "shipping today" |
621
- | Release checklist | "what do I need before releasing?", "release checklist", "anything missing before v2?" |
622
- | Version confidence | "is v3 ready?", "can I ship this version?", "pre-release check for 2.0" |
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 "is this ready" with no version/release framing → `/team-review`. Explicit release or version cut → `/pre-release`.
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, when the user is frustrated after trying multiple things, or when the problem could be in multiple layers (code + env + hidden failure).
576
+ Trigger when a bug has resisted normal debugging or spans multiple layers (code + env + hidden failure).
635
577
 
636
- | Signal | Real human phrasing |
578
+ | Signal | Examples |
637
579
  |---|---|
638
- | Persistent bug | "I've been fighting this bug for hours", "can't figure this out", "nothing is working", "tried everything" |
639
- | Multi-layer problem | "works locally not in CI", "works on my machine", "only fails in prod", "sometimes fails" |
640
- | Hidden failure | "no error but wrong behavior", "silently failing", "something is wrong but I don't know what" |
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 report → `debug-detective`. Persistent, multi-attempt, or multi-layer bug → `/debug-blitz`. Emotion of long frustration is a strong signal for blitz.
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 the user wants a comprehensive cleanup of existing code — not just one function, but a module, file, or system. Also trigger when multiple quality concerns are mentioned together (readability + types + tests).
592
+ Trigger when cleanup spans a module or file, especially when multiple concerns (readability + types + tests) come together.
653
593
 
654
- | Signal | Real human phrasing |
594
+ | Signal | Examples |
655
595
  |---|---|
656
- | Big cleanup | "refactor this module", "clean up this whole file", "this code is a mess", "technical debt cleanup" |
657
- | Multi-concern quality | "improve quality, types, and add tests", "make this cleaner and add coverage", "full cleanup" |
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:** Cleanup of one function → `refactor-cleaner`. Cleanup of a whole module/file with types and tests → `/refactor-sprint`.
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 — either a new team member, or the user themselves joining a project they didn't write.
607
+ Trigger when someone is new to a codebase and needs to understand it.
671
608
 
672
- | Signal | Real human phrasing |
609
+ | Signal | Examples |
673
610
  |---|---|
674
- | New to codebase | "I just joined the team", "new to this project", "inherited this codebase", "taking over this repo" |
675
- | Explore unfamiliar code | "never seen this code before", "trying to understand this project", "where do I even start?" |
676
- | Onboarding docs | "we need onboarding docs", "no documentation for new devs", "new dev joining, need to explain the codebase" |
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 or onboarding a new person → `/onboard`.
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. Also trigger proactively at session start if `tasks/lessons.md` exists in the project root.
623
+ Trigger when the user references project rules, preferences, corrections, or past instructions.
689
624
 
690
- | Signal | Real human phrasing |
625
+ | Signal | Examples |
691
626
  |---|---|
692
- | Load rules | "load my lessons", "what rules do we have", "what do you know about this project", "show me the rules" |
693
- | Remember something | "remember that we use pnpm", "remember I always want X", "don't forget Y", "note that we do X" |
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
- | Session start trigger | If `tasks/lessons.md` exists in the project root — proactively offer: "Found project lessons. Load them now?" |
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 and explain the time saving rather than picking just one:
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, 10 min vs 45 min)
708
- - "review my project before I deploy" → `/team-review` (4 agents, 15 min vs 60 min)
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** ("what does `git stash pop` do?") — answer directly
721
- - The message is **purely conversational** ("hi", "thanks", "ok", "got it") — respond normally
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 user is in the middle of a **defined multi-step workflow** initiated by another agent
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, needs something visual" | `image-architect` | Implicit visual need |
750
- | "make it look good / less empty" | `image-architect` | Visual quality signal |
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
- | "anything missing before I tag 1.0?" | `/pre-release` | Release checklist signal |
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 adversarial sweep |
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.