loki-mode 11.21.0 → 11.23.0

package/skills/00-index.md

@@ -1,239 +0,0 @@
-# Skill Modules Index
-
-<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
-## Contents
-
-- [Module Selection Rules](#module-selection-rules)
-- [Module Descriptions](#module-descriptions)
-  - [model-selection.md](#model-selectionmd)
-  - [quality-gates.md](#quality-gatesmd)
-  - [patterns-advanced.md](#patterns-advancedmd)
-  - [testing.md](#testingmd)
-  - [production.md](#productionmd)
-  - [troubleshooting.md](#troubleshootingmd)
-  - [agents.md](#agentsmd)
-  - [artifacts.md](#artifactsmd)
-  - [parallel-workflows.md](#parallel-workflowsmd)
-  - [github-integration.md](#github-integrationmd)
-  - [openspec-integration.md](#openspec-integrationmd)
-  - [mirofish-integration.md](#mirofish-integrationmd)
-  - [documentation.md](#documentationmd)
-  - [compound-learning.md (v5.30.0)](#compound-learningmd-v5300)
-  - [healing.md (v6.67.0)](#healingmd-v6670)
-  - [sdlc-fleet.md](#sdlc-fleetmd)
-  - [factory-operations.md](#factory-operationsmd)
-  - [release-cadence.md](#release-cadencemd)
-  - [extending.md](#extendingmd)
-  - [providers.md (v5.0.0)](#providersmd-v500)
-- [How to Load](#how-to-load)
-<!-- TOC:END -->
-
-**Load 1-3 modules based on your current task. Do not load all modules.**
-
-> **Full documentation:** For comprehensive details, see `references/` directory:
-> - `references/agent-types.md` - Complete 41 agent type specifications
-> - `references/openai-patterns.md` - OpenAI Agents SDK patterns
-> - `references/lab-research-patterns.md` - DeepMind + Anthropic research
-> - `references/production-patterns.md` - HN 2025 production insights
-> - `references/memory-system.md` - Episodic/semantic/procedural memory
-> - `references/tool-orchestration.md` - NVIDIA ToolOrchestra efficiency metrics
-> - `references/quality-control.md` - Code review and guardrails
-> - `references/magic-rarv-integration.md` - Autonomous magic generation in RARV-C cycle
-
-## Module Selection Rules
-
-| If your task involves... | Load these modules |
-|--------------------------|-------------------|
-| Writing code, implementing features | `model-selection.md` |
-| Running tests, E2E, Playwright | `testing.md` |
-| Code review, quality checks | `quality-gates.md` |
-| Deployment, CI/CD, infrastructure | `production.md` |
-| Debugging, errors, failures | `troubleshooting.md` |
-| Spawning subagents, Task tool | `model-selection.md`, `agents.md` |
-| Architecture, design decisions | `patterns-advanced.md` |
-| Generating artifacts, reports | `artifacts.md` |
-| Parallel features, git worktrees | `parallel-workflows.md` |
-| Scale patterns (50+ agents) | `parallel-workflows.md` + `references/cursor-learnings.md` |
-| GitHub issues, PRs, syncing | `github-integration.md` |
-| Multi-provider (Codex, Cline, Aider) | `providers.md` |
-| OpenSpec delta context, brownfield modifications | `openspec-integration.md` |
-| MiroFish market validation, `--mirofish` flag | `mirofish-integration.md` |
-| Writing/updating documentation, `loki docs` | `documentation.md` |
-| UI components, design tokens, .loki/magic/, Gate 12 | `magic-modules.md` |
-| Legacy healing, modernization, archaeology | `healing.md` |
-| Plan deepening, knowledge extraction | `compound-learning.md` |
-| Managed Agents memory, multiagent council, flag hierarchy | `memory.md` |
-| Non-trivial change (>3 files, agent runtime, MINOR/MAJOR release) | `sdlc-fleet.md` |
-| Several agent teams running at once, file ownership, WIP limits | `factory-operations.md` |
-| Cutting a release, version bump, publish verification | `release-cadence.md` |
-| Adding your own gate/reviewer/agent to the loop | `extending.md` |
-
-## Module Descriptions
-
-### model-selection.md
-**When:** Spawning subagents, choosing models, parallelization
-- Task tool parameters and examples
-- Opus/Sonnet/Haiku usage patterns
-- Extended thinking mode prefixes
-- Prompt repetition for Haiku
-- Background agents and resumption
-
-### quality-gates.md
-**When:** Code review, pre-commit checks, quality assurance
-- 8-gate quality system (gate 7: documentation coverage, v6.75.0; backward compatibility is a conditional healing-mode auditor, not numbered)
-- Blind review + anti-sycophancy
-- Velocity-quality feedback loop (arXiv research)
-- Mandatory quality checks per task
-- Guardrails (input/output validation)
-
-### patterns-advanced.md
-**When:** Architecture decisions, complex problem-solving
-- OptiMind problem classification + expert hints
-- Ensemble solution generation
-- Formal state machines (k8s-valkey-operator)
-- Constitutional AI self-critique
-- Debate-based verification (DeepMind)
-- Code-Only agent pattern (code witnesses)
-
-### testing.md
-**When:** Writing tests, E2E automation, verification
-- Playwright MCP for browser testing
-- Property-based testing (Kiro pattern)
-- Unit/integration/E2E strategies
-- Visual design input workflow
-
-### production.md
-**When:** Deployment, CI/CD, production concerns
-- Pointer to HN 2025 patterns in references/production-patterns.md
-- Git worktree isolation (Cursor pattern)
-- Atomic checkpoint/rollback
-- CI/CD automation (Zencoder patterns)
-- Context engineering and proactive compaction
-
-### troubleshooting.md
-**When:** Errors, failures, debugging
-- Common issues and solutions
-- Red flags (never do these)
-- Multi-tiered fallback system
-- Rate limit handling
-- Circuit breakers
-
-### agents.md
-**When:** Understanding agent types, structured prompting
-- 41 agent type overview
-- Structured prompting format (GOAL/CONSTRAINTS/CONTEXT/OUTPUT)
-- Agent handoffs and callbacks
-- Routing mode optimization
-
-### artifacts.md
-**When:** Generating reports, documentation, screenshots
-- Artifact generation (Antigravity pattern)
-- Code transformation (Amazon Q pattern)
-- Phase completion reports
-- Screenshot gallery generation
-
-### parallel-workflows.md
-**When:** Running multiple features in parallel, worktree orchestration
-- Git worktree-based isolation
-- Parallel Claude sessions (feature, testing, docs streams)
-- Inter-stream communication via signals
-- Auto-merge completed features
-- Orchestrator state management
-- Supervisor / judge pattern (CONTINUE / COMPLETE / ESCALATE / PIVOT)
-- Dynamic resource-aware session concurrency (LOKI_DYNAMIC_CONCURRENCY)
-
-### github-integration.md
-**When:** Working with GitHub issues, creating PRs, syncing status
-- Import open issues as pending tasks
-- Create PRs on feature completion
-- Sync task status back to GitHub issues
-- Filter by labels, milestone, assignee
-- Requires `gh` CLI authenticated
-
-### openspec-integration.md
-**When:** Working with OpenSpec delta context, `--openspec` flag, brownfield modifications
-- Delta-aware development rules (ADDED/MODIFIED/REMOVED)
-- Task execution by group order
-- Scenario-to-test mapping (GIVEN/WHEN/THEN)
-- Source mapping and verification tracking
-- Complexity-based agent strategy
-
-### mirofish-integration.md
-**When:** Project has MiroFish market validation data, `--mirofish` flag used
-- Market validation context interpretation
-- Sentiment-aware feature prioritization
-- Risk-driven task ordering
-- Advisory-only (never gates RARV or Completion Council)
-
-### documentation.md
-**When:** Writing/updating documentation, `loki docs` commands, Repowise MCP available
-- Documentation types (README, ARCHITECTURE, API, DECISIONS, etc.)
-- Model selection for doc generation (Sonnet/Haiku/Opus)
-- Repowise MCP integration for codebase intelligence
-- Documentation quality criteria and prompts
-- Fallback to native git analysis when Repowise unavailable
-
-### compound-learning.md (v5.30.0)
-**When:** After architecture phase (deepen plan), after verification (extract learnings)
-- Deepen-plan: 4 parallel research agents enhance plans before implementation
-- Knowledge compounding: Extract structured solutions from task outcomes
-- Solution retrieval: Load relevant cross-project solutions during REASON phase
-- Composable phases: plan, deepen, work, review, compound
-
-### healing.md (v6.67.0)
-**When:** Legacy codebase modernization, `loki heal`, brownfield projects, code archaeology
-- 5 healing principles (friction-as-semantics, failure-first, adapters, incremental, knowledge preservation)
-- Healing RARV cycle (characterize before modifying)
-- Codebase archaeology protocol
-- Friction map management
-- Healing phase gates (archaeology > stabilize > isolate > modernize > validate)
-- Legacy-healing-auditor code review specialist
-- Language-specific guides (COBOL, legacy Java, PHP, Python 2)
-- Full reference: `references/legacy-healing-patterns.md`
-
-### sdlc-fleet.md
-**When:** Any non-trivial change (feature touching >3 files, bug fix in agent
-runtime / council / memory / auto-spawn, MINOR or MAJOR release, cross-route
-parity change). Binding per CLAUDE.md, so this index must be able to route to it.
-- Six roles: Architect, Product Owner, Dev Fleet, SDET, Council Reviewers, Real-User QA
-- Unanimous 3-of-3 APPROVE required from the review council
-- Skip rules: typo fixes, docs-only edits, reverts, emergency hotfixes
-
-### factory-operations.md
-**When:** More than one agent team is working the repo at the same time
-- Roles and the DECIDES vs ADVISES split (CoS, PM, Dev Fleet, SDET, Council, Release Captain)
-- Per-file ownership: the lead never edits a file an agent owns
-- WIP limits, and what a blocked team does instead of waiting
-- The spine: a measurement that cannot see what it claims to measure is worse than none
-
-### release-cadence.md
-**When:** Taking a change from merged to published
-- The fast tier is the release gate; the full tier is not a blocker
-- VERSION must be the push HEAD or the release workflow never fires
-- Verify the artifact a user installs, never a green job or an exit code
-
-### extending.md
-**When:** Adding a custom reviewer/agent to the loop without editing engine files
-- The live seam: `loki agent install` -> `.loki/agents/installed.json`
-- What is strictly additive vs what can never displace a built-in gate
-- Honest status of `src/plugins/` (built, tested, not wired into the loop)
-
-### providers.md (v5.0.0)
-**When:** Using non-Claude providers (Codex, Cline, Aider), understanding degraded mode
-- Provider comparison matrix
-- Claude (full features) vs Codex/Cline/Aider (degraded mode)
-- Provider selection via CLI flag or environment variable
-- Model tier mapping (planning/development/fast)
-- Degraded mode limitations and behavior
-
-## How to Load
-
-```python
-# Example: Before implementing a feature with tests
-# 1. Read this index
-# 2. Decide: need model-selection.md + testing.md
-# 3. Read those files
-# 4. Execute with loaded context
-```
-
-**Remember:** Loading fewer modules = more context for actual work.