@uoyo/mvtt 2.0.0-beta.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrD,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,yCAAyC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACvC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/types/manifest.d.ts

@@ -0,0 +1,21 @@
+export interface SectionInline {
+    type: "inline";
+    content: string;
+}
+export interface SectionFile {
+    type: "file";
+    source: string;
+}
+export interface SectionShared {
+    type: "shared" | "template";
+    source: string;
+    params?: Record<string, unknown>;
+}
+export type Section = SectionInline | SectionFile | SectionShared;
+export interface Manifest {
+    name: string;
+    output: string;
+    frontmatter: Record<string, string>;
+    sections: Section[];
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/types/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC;AAElE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB"}

package/dist/types/manifest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/types/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":""}

package/dist/types/registry.d.ts

@@ -0,0 +1,25 @@
+export interface NextSuggestions {
+    primary: string;
+    primary_desc: string;
+    alternatives?: Array<{
+        skill: string;
+        when: string;
+    }>;
+}
+export interface SkillEntry {
+    agent: string;
+    description: string;
+    path: string;
+    template: string | null;
+    category: "workflow" | "shortcut" | "utility" | "project";
+    mode: string;
+    phase?: string | null;
+    depends_on?: string[];
+    next_suggestions?: NextSuggestions;
+}
+export interface Registry {
+    version: string;
+    last_updated: string;
+    skills: Record<string, SkillEntry>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/types/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC"}

package/dist/types/registry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/types/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":""}

package/dist/util/color.d.ts

@@ -0,0 +1,9 @@
+export declare const color: {
+    green: (s: string) => string;
+    yellow: (s: string) => string;
+    red: (s: string) => string;
+    cyan: (s: string) => string;
+    gray: (s: string) => string;
+    bold: (s: string) => string;
+};
+//# sourceMappingURL=color.d.ts.map

package/dist/util/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,KAAK;eACL,MAAM;gBACL,MAAM;aACT,MAAM;cACL,MAAM;cACN,MAAM;cACN,MAAM;CACjB,CAAC"}

package/dist/util/color.js

@@ -0,0 +1,13 @@
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+function wrap(code, text) {
+    return useColor ? `\x1b[${code}m${text}\x1b[0m` : text;
+}
+export const color = {
+    green: (s) => wrap(32, s),
+    yellow: (s) => wrap(33, s),
+    red: (s) => wrap(31, s),
+    cyan: (s) => wrap(36, s),
+    gray: (s) => wrap(90, s),
+    bold: (s) => wrap(1, s),
+};
+//# sourceMappingURL=color.js.map

package/dist/util/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAE/D,SAAS,IAAI,CAAC,IAAY,EAAE,IAAY;IACtC,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAClC,GAAG,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;CAChC,CAAC"}

package/dist/util/package.d.ts

@@ -0,0 +1,3 @@
+export declare function getPackageRoot(): string;
+export declare function getVersion(): string;
+//# sourceMappingURL=package.d.ts.map

package/dist/util/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/util/package.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAKnC"}

package/dist/util/package.js

@@ -0,0 +1,13 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export function getPackageRoot() {
+    return path.resolve(__dirname, "..", "..");
+}
+export function getVersion() {
+    const pkg = JSON.parse(readFileSync(path.resolve(getPackageRoot(), "package.json"), "utf-8"));
+    return pkg.version;
+}
+//# sourceMappingURL=package.js.map

package/dist/util/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/util/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CACtE,CAAC;IACF,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC"}

package/install-manifest.yaml

@@ -0,0 +1,27 @@
+version: 2
+
+generated:
+  - pattern: ".claude/skills/mvt-*/SKILL.md"
+    source: "build:skills"
+  - pattern: ".ai-agents/skills/_templates/*-output.md"
+    source: "build:templates"
+  - pattern: ".ai-agents/knowledge/core/**"
+    source: "copy:sources/knowledge/core/"
+  - pattern: ".ai-agents/knowledge/patterns/**"
+    source: "copy:sources/knowledge/patterns/"
+  - pattern: ".ai-agents/registry.yaml"
+    source: "copy:registry.yaml"
+
+create_once:
+  - path: ".ai-agents/config.yaml"
+    source: "sources/defaults/config.yaml"
+  - path: ".ai-agents/workspace/session.yaml"
+    source: "sources/defaults/session.yaml"
+  - path: ".ai-agents/workspace/project-context.yaml"
+    source: "sources/defaults/project-context.yaml"
+
+user_data_dirs:
+  - ".ai-agents/workspace/artifacts/"
+  - ".ai-agents/skills/_templates/custom/"
+  - ".ai-agents/knowledge/principle/"
+  - ".ai-agents/knowledge/project/"

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@uoyo/mvtt",
+  "version": "2.0.0-beta.0",
+  "description": "My Virtual Tech Team - AI-guided prompt orchestration framework",
+  "type": "module",
+  "bin": {
+    "mvtt": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "sources/",
+    "registry.yaml",
+    "install-manifest.yaml"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "prompt-engineering",
+    "claude-code",
+    "cli",
+    "orchestration"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/uoyoCsharp/My-Virtual-TechTeam.git"
+  },
+  "bugs": {
+    "url": "https://github.com/uoyoCsharp/My-Virtual-TechTeam/issues"
+  },
+  "homepage": "https://github.com/uoyoCsharp/My-Virtual-TechTeam#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@types/prompts": "^2.4.9",
+    "@vitest/coverage-v8": "^2.1.9",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "prompts": "^2.4.2",
+    "yaml": "^2.4.0"
+  },
+  "license": "MIT"
+}

package/registry.yaml

@@ -0,0 +1,209 @@
+# MVTT Framework Registry (v2)
+# Single source of truth for skill metadata. Consumed at build-time by mvtt CLI
+# and at runtime by /mvt-status and /mvt-help.
+
+version: "2.0"
+last_updated: "2026-04-28"
+
+skills:
+  # --- Conductor Skills ---
+  mvt-init:
+    agent: conductor
+    description: "Initialize or refresh a project with comprehensive analysis"
+    path: .claude/skills/mvt-init/SKILL.md
+    template: .ai-agents/skills/_templates/init-output.md
+    category: project
+    mode: independent
+    phase: null
+    depends_on: []
+    next_suggestions:
+      primary: mvt-analyze
+      primary_desc: "Start analyzing requirements"
+
+  mvt-status:
+    agent: conductor
+    description: "Show current project and workflow status"
+    path: .claude/skills/mvt-status/SKILL.md
+    template: .ai-agents/skills/_templates/status-output.md
+    category: project
+    mode: independent
+    phase: null
+    depends_on: []
+
+  mvt-config:
+    agent: conductor
+    description: "Interactive configuration management for framework settings"
+    path: .claude/skills/mvt-config/SKILL.md
+    template: .ai-agents/skills/_templates/config-output.md
+    category: project
+    mode: independent
+    phase: null
+    depends_on: []
+
+  mvt-sync-context:
+    agent: conductor
+    description: "Synchronize workspace context with code changes"
+    path: .claude/skills/mvt-sync-context/SKILL.md
+    template: .ai-agents/skills/_templates/sync-context-output.md
+    category: project
+    mode: independent
+    phase: null
+    depends_on: []
+
+  mvt-cleanup:
+    agent: conductor
+    description: "Clean up workspace artifacts and maintain workspace health"
+    path: .claude/skills/mvt-cleanup/SKILL.md
+    template: .ai-agents/skills/_templates/cleanup-output.md
+    category: project
+    mode: independent
+    phase: null
+    depends_on: []
+
+  # --- Analyst Skills ---
+  mvt-analyze:
+    agent: analyst
+    description: "Analyze requirements documents and extract domain concepts"
+    path: .claude/skills/mvt-analyze/SKILL.md
+    template: .ai-agents/skills/_templates/analyze-output.md
+    category: workflow
+    mode: full-workflow
+    phase: analyze
+    depends_on: []
+    next_suggestions:
+      primary: mvt-design
+      primary_desc: "Create architecture based on this analysis"
+
+  mvt-analyze-code:
+    agent: analyst
+    description: "Reverse-analyze existing code to generate context"
+    path: .claude/skills/mvt-analyze-code/SKILL.md
+    template: .ai-agents/skills/_templates/analyze-code-output.md
+    category: workflow
+    mode: independent
+    phase: null
+    depends_on: []
+
+  # --- Architect Skills ---
+  mvt-design:
+    agent: architect
+    description: "Create architecture design based on analyzed requirements"
+    path: .claude/skills/mvt-design/SKILL.md
+    template: .ai-agents/skills/_templates/design-output.md
+    category: workflow
+    mode: full-workflow
+    phase: design
+    depends_on: [mvt-analyze]
+    next_suggestions:
+      primary: mvt-implement
+      primary_desc: "Implement features based on this design"
+
+  # --- Developer Skills ---
+  mvt-implement:
+    agent: developer
+    description: "Implement features based on architecture design"
+    path: .claude/skills/mvt-implement/SKILL.md
+    template: .ai-agents/skills/_templates/implement-output.md
+    category: workflow
+    mode: full-workflow
+    phase: implement
+    depends_on: [mvt-design]
+    next_suggestions:
+      primary: mvt-review
+      primary_desc: "Review the implementation"
+
+  mvt-fix:
+    agent: developer
+    description: "Diagnose and fix bugs or issues in the codebase"
+    path: .claude/skills/mvt-fix/SKILL.md
+    template: .ai-agents/skills/_templates/fix-output.md
+    category: shortcut
+    mode: shortcut
+    phase: null
+    depends_on: []
+
+  mvt-refactor:
+    agent: developer
+    description: "Refactor existing code while preserving behavior"
+    path: .claude/skills/mvt-refactor/SKILL.md
+    template: .ai-agents/skills/_templates/refactor-output.md
+    category: shortcut
+    mode: shortcut
+    phase: null
+    depends_on: []
+
+  # --- Reviewer Skills ---
+  mvt-review:
+    agent: reviewer
+    description: "Perform code review for quality and standards compliance"
+    path: .claude/skills/mvt-review/SKILL.md
+    template: .ai-agents/skills/_templates/review-output.md
+    category: workflow
+    mode: full-workflow
+    phase: review
+    depends_on: [mvt-implement]
+    next_suggestions:
+      primary: mvt-fix
+      primary_desc: "Address critical issues"
+
+  # --- Tester Skills ---
+  mvt-test:
+    agent: tester
+    description: "Generate and design tests to validate implementations"
+    path: .claude/skills/mvt-test/SKILL.md
+    template: .ai-agents/skills/_templates/test-output.md
+    category: workflow
+    mode: full-workflow
+    phase: test
+    depends_on: [mvt-implement]
+
+  # --- Utility Skills ---
+  mvt-help:
+    agent: conductor
+    description: "Show available skills, current project status, and workflow guidance"
+    path: .claude/skills/mvt-help/SKILL.md
+    template: null
+    category: utility
+    mode: independent
+    phase: null
+    depends_on: []
+
+  mvt-create-skill:
+    agent: conductor
+    description: "Create custom MVTT skills through interactive guided workflow"
+    path: .claude/skills/mvt-create-skill/SKILL.md
+    template: null
+    category: utility
+    mode: independent
+    phase: null
+    depends_on: []
+
+  mvt-add-context:
+    agent: conductor
+    description: "Interactively add or update project context information"
+    path: .claude/skills/mvt-add-context/SKILL.md
+    template: null
+    category: utility
+    mode: independent
+    phase: null
+    depends_on: []
+
+  mvt-check-context:
+    agent: conductor
+    description: "Analyze context token load and give optimization recommendations"
+    path: .claude/skills/mvt-check-context/SKILL.md
+    template: .ai-agents/skills/_templates/context-check-output.md
+    category: utility
+    mode: independent
+    phase: null
+    depends_on: []
+
+  mvt-template:
+    agent: conductor
+    description: "View, customize, and manage output templates for MVTT skills"
+    path: .claude/skills/mvt-template/SKILL.md
+    template: null
+    category: utility
+    mode: independent
+    phase: null
+    depends_on: []

package/sources/defaults/config.yaml

@@ -0,0 +1,30 @@
+# MVTT Framework - User Configuration
+# Unified config center: all skills read and enforce these settings via Activation Protocol
+# Modify via: /mvt-config or edit directly
+
+version: "2.0"
+
+# ============================================================
+# User Preferences (enforced by Activation Protocol Step 2)
+# ============================================================
+preferences:
+  # Output language for all skill responses and document artifacts
+  # Options: en-US, zh-CN
+  language: en-US
+
+  # Output style
+  output:
+    no_emojis: true          # Disable emojis in output
+    data_format: yaml        # Data output format: yaml | json
+
+# ============================================================
+# Pattern Settings
+# ============================================================
+pattern:
+  # Active architecture pattern
+  # Use /mvt-init to auto-detect or /mvt-config to change
+  active: ""
+
+  selection:
+    auto_detect: true
+    confirm_with_user: true

package/sources/defaults/project-context.yaml

@@ -0,0 +1,26 @@
+# Unified Project Context
+# Merges: project.yaml + architecture.yaml + requirements.yaml + decisions.yaml
+
+project:
+  name: ""
+  type: ""
+  initialized_at: ""
+  tech_stack:
+    language: ""
+    framework: ""
+    build_tool: ""
+    test_framework: ""
+
+# Requirements summary (written by #analyze)
+requirements:
+  features: []
+  actors: []
+  business_rules: []
+  clarifications: []
+
+# Architecture design (written by #design)
+architecture:
+  overview: ""
+  modules: []
+  components: []
+  decisions: []    # ADR list (merged from former decisions.yaml)

package/sources/defaults/session.yaml

@@ -0,0 +1,23 @@
+# Workspace Session State
+# Simplified session state — only fields LLM actually needs
+
+session:
+  initialized_at: ""
+  last_command: ""
+
+# Current active change (created by #analyze)
+active_change:
+  id: ""
+  title: ""
+  created_at: ""
+
+# Workflow progress (simplified: pending | done)
+progress:
+  analyze: pending
+  design: pending
+  implement: pending
+  review: pending
+  test: pending
+
+# Recent actions (append-only, keep max 3)
+recent_actions: []

package/sources/knowledge/core/manifest.yaml

@@ -0,0 +1,47 @@
+id: "core"
+type: "core"
+name: "Core Knowledge"
+version: "1.0"
+description: "Actionable review principles for code quality"
+
+token_estimate:
+  total: 800
+  breakdown:
+    - file: review-principles.md
+      tokens: 800
+      load_priority: 1
+      summary: "Naming, SRP, dependency direction, error handling, duplication, state, testing checklist"
+
+loading_strategy:
+  level_1_overview:
+    description: "Read manifest only for summary"
+    tokens: 100
+    use_case: "Check available knowledge"
+
+  level_2_full:
+    description: "Load complete knowledge files"
+    tokens: 800
+    use_case: "Complete principles reference"
+
+loading:
+  priority: 1
+  auto_load: true
+
+files:
+  - path: "review-principles.md"
+    description: "Actionable code review checklist: naming, SRP, dependencies, errors, duplication, state, testing"
+    required: true
+    tokens: 800
+
+attributes:
+  checklist: []
+
+scenarios:
+  - name: "Code review"
+    files: ["review-principles.md"]
+
+  - name: "Refactoring guidance"
+    files: ["review-principles.md"]
+
+  - name: "Architecture design"
+    files: ["review-principles.md"]

package/sources/knowledge/core/review-principles.md

@@ -0,0 +1,51 @@
+# Code Review Principles
+
+Actionable checklist for reviewing code quality. Use during `#review` and as reference during `#implement`.
+
+## Naming & Readability
+
+- [ ] Classes/functions named by **what they do**, not how they do it
+- [ ] No abbreviations unless universally understood (e.g., `id`, `url`, `http`)
+- [ ] Boolean variables/methods start with `is`, `has`, `can`, `should`
+- [ ] Collections named as plural nouns; single items as singular
+- [ ] No "Manager", "Helper", "Utils" god-classes — split by responsibility
+
+## Single Responsibility
+
+- [ ] Each class/module has **one reason to change**
+- [ ] Functions do **one thing** and are ≤ 30 lines (guideline, not hard rule)
+- [ ] If you need "and" to describe what a function does → split it
+
+## Dependency Direction
+
+- [ ] Business logic does NOT import framework/infrastructure code
+- [ ] Dependencies point **inward** (infrastructure → application → domain)
+- [ ] External services accessed through **interfaces/abstractions**
+- [ ] No circular dependencies between modules
+
+## Error Handling
+
+- [ ] Errors are handled at the **appropriate level** (not swallowed silently)
+- [ ] Fail fast: validate inputs at entry points
+- [ ] No empty catch blocks
+- [ ] Error messages include **context** (what failed, why, what to do)
+
+## Duplication & Abstraction
+
+- [ ] No copy-paste blocks — extract shared logic into functions
+- [ ] But: don't merge similar-looking code that changes for **different reasons**
+- [ ] Abstractions are justified by **current** requirements, not hypothetical ones
+- [ ] No dead code or commented-out blocks
+
+## State & Side Effects
+
+- [ ] Mutable state is **minimized** and localized
+- [ ] Functions clearly indicate whether they have side effects
+- [ ] No hidden global state mutations
+- [ ] Concurrent access to shared state is protected
+
+## Testing Indicators
+
+- [ ] Public API has clear contracts that are testable
+- [ ] Dependencies are injectable (not hard-coded `new`)
+- [ ] No logic in constructors that makes testing difficult