ai-developer-skill-os 8.2.1 → 8.3.1

package/.agents/CHANGELOG.md

@@ -1,131 +0,0 @@
-# Changelog
-
-All notable changes to AI Developer Skill OS are documented here.
-Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
-
----
-
-## [8.2.0] — 2026-07 — EDAOS v8.2: Governed Capability Metadata & Eval Platform
-
-### Added
-- **Manifest-First Architecture & Registry Engine**: Created `tooling/build-registry.js` (`npm run build:registry`) generating lightweight lookup index `.agents/registry/index.yaml` and O(1) runtime adjacency graph `.agents/registry/graph.json` with cycle/orphan detection.
-- **V8.2 Blueprint Plugins**: Introduced customizable project scaffolding templates under `.agents/blueprints/` (`rag`, `coding`, `workflow`) featuring multi-profile environments (`development`, `production`, `testing`) and feature flags.
-- **Governed Capability Manifests**: Created minimalist `.agents/skills/_template/capability.yaml` (`schema_version: 1`) to decouple execution metadata from natural language instructions.
-- **Eval Pipeline Platform**: Added quantitative verification frameworks via inheritance-ready `.agents/skills/_template/evals/scorecard.yaml` (`extends: default`), linking ground-truth execution traces with automated score rubrics.
-- **Domain Patterns Reference Architecture**: Added reference blueprint for Enterprise Domain AI at `.agents/knowledge/domain-patterns/construction/ddc-construction-ai-blueprint.md` (Construction AI, DDC 192 domain skills, QTO IFC bóc tách, n8n automation workflows) showcasing zero interference with core developer capabilities.
-
-### Changed
-- **`qk-project-bootstrap` Evolution (v8.2.0)**: Upgraded to support One-Click Blueprint selection, automated `project.yaml` generation, and the Universal 4-Folder RAG Architecture (`prompts/`, `data/`, `agents/`, `evals/`).
-- **`qk-validation-gate` Evolution (v8.2.0)**: Integrated automated Eval Pipeline validation, reading `scorecard.yaml` rubrics, verifying trace logs in `evals/traces/`, and enforcing quantitative pass thresholds.
-- **`qk-ai-builder` Evolution (v8.2.0)**: Upgraded to Manifest-first capability packaging and strict 4-folder data discipline (immutable `data/raw/` vs cleaned `data/processed/`).
-- Updated system core description in `package.json` to reflect the EDAOS v8.2 paradigm shift.
-- Synced `.agents/CHANGELOG.md` and `.agents/README.md` with root documentation.
-
----
-
-## [8.1.7] — 2026-07 — README Sync
-
-### Changed
-- **README Sync**: Synced `.agents/README.md` with root `README.md` so the installed documentation is fully up-to-date with V8.1 architecture.
-- Bumped version to `8.1.7`.
-
----
-
-## [8.1.6] — 2026-07 — Design Intelligence Content & Sync
-
-### Added
-- **Design Intelligence Populated**: Sourced core market-standard knowledge (Tailwind, Radix, Apple, Vercel-like principles) into `.agents/knowledge/design-intelligence/` covering components, patterns, industries, themes, and references.
-- **Animation Knowledge**: Added `visual-language/animation.md` for micro-interactions and transition durations.
-- **Dependency Wiring**: Linked `qk-ui-system-builder` to `design-intelligence` so it utilizes the newly generated design constraints.
-- **Changelog Sync**: Synced `.agents/CHANGELOG.md` with root `CHANGELOG.md` so the installed copy reflects the true V8 evolution.
-
-### Changed
-- All skill descriptions properly translated to Vietnamese for ecosystem consistency.
-- Bumped version to `8.1.6` for final, truly complete Design Intelligence NPM Release.
-
----
-
-## [8.1.4] — 2026-07 — Design Intelligence Pack
-
-### Added
-- **Design Intelligence Layer**: `.agents/knowledge/design-intelligence/` (industries, themes, patterns, visual-language, components, templates)
-- **Knowledge Dependencies**: `qk-design-system-engineering` and `qk-ui-builder` now have strict dependency bounds tied to Design Intelligence without bloating the Capability Graph.
-- **Design Routing Test Cases**: `design-intel-01`, `02`, `03` for validating routing logic in design scenarios.
-- **Re-introduced CLI Installer**: Restored and refactored `bin/install.js` to correctly copy `.agents` across global/local directories for easy NPM setup.
-
-### Changed
-- Refined **Decision Boundaries**: `qk-ui-builder` explicitly forbidden from defining visual direction or brand identity (strict capability bounds).
-- **README.md** reflects 30 Master Skills and the "Agent Engineering OS" mindset.
-- **package.json**: Version bump `8.1.4` and whitelisted files for npm publish.
-
----
-
-## [8.1.3] — 2026-07 — Architecture Freeze & Governance
-
-### Added
-- **Capability Graph & Routing**: `.agents/registry/capability-graph.yml` to define skill relations (`depends_on`, `delegates_to`).
-- **Priority Governance**: `.agents/rules/priorities.yml` enforcing safety layers (`P1: System Integrity`, `P2: Guardrails`).
-- **Audit Tools**: `tooling/run-aar.js` for architectural acceptance testing.
-- Test cases for routing and boundary attacks.
-
-### Changed
-- Name transition from "Self-Improving" to **Adaptive Agent OS** (Self Optimizing ≠ Self Modifying).
-- Enforced hard cap of **30 Skills** to prevent Skill Inflation.
-- Frozen Baseline achieved: `v8.1.3-agent-os-production`.
-
----
-
-## [8.0.0] — 2026-07 — Agent Knowledge System
-
-### Philosophy shift
-- **V7:** Skill Repository — human selects skill, AI executes
-- **V8:** Agent Knowledge System — AI retrieves context, selects capability, executes workflow, verifies
-
-### Added
-- `rules/` — Agent behavior policies (global, coding, safety)
-- `workflows/` — Reusable execution pipelines (YAML, with inputs/outputs per step)
-- `examples/` — Few-shot knowledge (good/, bad/)
-- `learnings/` — Evidence-based learning lifecycle (draft/, validated/, deprecated/)
-- `registry/` — Generated AI retrieval index (skills-index.yml)
-- `docs/ARCHITECTURE.md` — Agent request flow diagram
-- `docs/VERSIONING.md` — Semantic versioning policy
-- `docs/schemas/` — Schema definitions for all knowledge objects
-- `docs/decisions/` — Architecture Decision Records (ADRs)
-- `.agentsignore` — AI boundary file (what agents should NOT load)
-- `tooling/` — Dev automation (generate-registry.js, validate-skills.js)
-- `tests/agent-evaluation/` — Agent behavior test harness
-
-### Changed
-- SKILL.md schema upgraded to V8: added `type`, `intent`, `triggers`, `complexity`, `workflow`, `verification`, `related_skills`
-- `skills.json` demoted to **generated compatibility manifest** (source of truth = SKILL.md)
-- Workflows extracted from individual skills → shared reusable templates
-
-### Removed
-- Embedded workflows inside SKILL.md body (moved to workflows/)
-- Old migration scripts (migrate-v*.js, patch*.py, add_lang.*, etc.)
-- Duplicate documentation (CLAUDE.md, old docs/)
-- Experimental packages (packages/edaos-sdk)
-- framework/, knowledge/, specs/, templates/ directories
-
-### Migration
-- V7.5.1 tagged at git: `v7.5.1`
-- V7 skills preserved in git history; migration is additive schema upgrade
-
----
-
-## [7.5.1] — 2026-07 — Final V7 Release
-
-- Bumped all skill versions to 7.5.1
-- Added qk-fe-api-integration skill
-- Added qk-performance-tuner (global config)
-- Stabilized frontmatter schema across all 22 skills
-
-## [7.5.0] — 2026-07
-
-- Major skills refactor with EDAOS runtime adapter
-- Added MCP server integration
-- Added qk-bug-resolution workflow contracts
-
-## [7.0.0] — 2026
-
-- V7 release: 22 skills, YAML frontmatter, token budget system

package/.agents/learnings/draft/README.md

@@ -1,37 +0,0 @@
-# Learning Draft — Placeholder
-
-This directory contains draft learnings created by AI agents or humans that have NOT yet been validated.
-
-## How to add a draft learning
-
-Create a new file: `YYYY-MM-[short-slug].md`
-
-```markdown
----
-claim: "..."
-context: "When does this apply?"
-lifecycle: draft
-observed_by: agent | human
-observed_date: YYYY-MM
-related_skills: []
----
-
-## Observation
-
-What was observed?
-
-## Why it matters
-
-Why is this worth noting?
-
-## Counter examples (if any)
-
-When does this NOT apply?
-```
-
-## How to promote to validated
-
-1. Fill the `evidence` field with links to issues/experiments
-2. Human reviews and agrees
-3. Move file to `validated/`
-4. Git commit with `[validated]` in message

package/.agents/reports/RELEASE-CHECKLIST.md

@@ -1,29 +0,0 @@
-# V8.1.3 Production Freeze Checklist
-
-## Skills
-[x] 30 skills validated
-[x] Missing `delegates_to` allowed for implementation skills
-
-## Graph
-[x] No orphan nodes
-[x] No cycles
-[x] Hub risk evaluated
-
-## Workflow
-[x] All skills mapped to workflows
-
-## Rules
-[x] Priority matrix exists (`priorities.yml`)
-[x] Strict constraint applied
-
-## Evaluation
-[x] 18 cases passed
-[x] Boundary Attack handled correctly
-[x] Ambiguous intent detected
-[x] Adversarial intent rejected
-
-## Registry
-[x] Generated successfully
-
-**Status:**
-APPROVED

package/.agents/reports/architecture-audit.md

@@ -1,13 +0,0 @@
-# Architecture & Workflow Audit
-
-## Workflows Found: 10
-- bug-resolution.yml
-- code-review.yml
-- documentation.yml
-- feature-delivery.yml
-- refactor.yml
-- research.yml
-- security-audit.yml
-- skill-evolution.yml
-- spec-driven-development.yml
-- _schema.yml

package/.agents/reports/graph-health.md

@@ -1,20 +0,0 @@
-# Graph Health Report
-
-## Hub Risk Analysis
-
-## Conflict Matrix
-- **qk-design-system-engineering** conflicts **qk-ui-system-builder**
-  - Reason: Semantic overlap
-  - Severity: High
-  - Resolution: Context loader intervention required
-
-- **qk-devops-platform** conflicts **qk-production-release**
-  - Reason: Semantic overlap
-  - Severity: High
-  - Resolution: Context loader intervention required
-
-- **qk-frontend-architecture** conflicts **qk-ui-builder**
-  - Reason: Semantic overlap
-  - Severity: High
-  - Resolution: Context loader intervention required
-

package/.agents/reports/skill-audit.md

@@ -1,215 +0,0 @@
-# Skill Audit Report
-
-## qk-access-policy
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-agent-observability
-- `owns`: ✅
-- `does_not_own`: ✅
-- `conflicts_with`: ✅
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 100/100**
-
-## qk-ai-builder
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-api-lifecycle
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-bug-resolution
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-context-loader
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-data-lifecycle
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-db-optimizer
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-design-system-engineering
-- `owns`: ✅
-- `does_not_own`: ✅
-- `conflicts_with`: ✅
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 100/100**
-
-## qk-devops-platform
-- `owns`: ✅
-- `does_not_own`: ✅
-- `conflicts_with`: ✅
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 100/100**
-
-## qk-docs
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-engineering-standard
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-fe-api-integration
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-feature-delivery
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-frontend-architecture
-- `owns`: ✅
-- `does_not_own`: ✅
-- `conflicts_with`: ✅
-- `delegates_to`: ✅
-**Boundary Health Score: 100/100**
-
-## qk-help
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-orchestrator
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 0/100**
-
-## qk-product-specification
-- `owns`: ✅
-- `does_not_own`: ✅
-- `conflicts_with`: ✅
-- `delegates_to`: ✅
-**Boundary Health Score: 100/100**
-
-## qk-production-release
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-project-bootstrap
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-project-health
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-project-memory
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-security-audit
-- `owns`: ✅
-- `does_not_own`: ✅
-- `conflicts_with`: ✅
-- `delegates_to`: ✅
-**Boundary Health Score: 100/100**
-
-## qk-system-evolution
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-test-engineering
-- `owns`: ✅
-- `does_not_own`: ✅
-- `conflicts_with`: ✅
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 100/100**
-
-## qk-ui-audit
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-ui-builder
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-ui-system-builder
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-validation-gate
-- `owns`: ❌
-- `does_not_own`: ❌
-- `conflicts_with`: ❌
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 20/100**
-
-## qk-web-quality-gate
-- `owns`: ✅
-- `does_not_own`: ✅
-- `conflicts_with`: ✅
-- `delegates_to`: ➖ (Optional)
-**Boundary Health Score: 100/100**
-
-
-**Total Scanned:** 30
-**Total Passed (>=80):** 8

package/tooling/generate-registry.js

@@ -1,157 +0,0 @@
-/**
- * generate-registry.js
- * Generates registry/skills-index.yml and registry/capability-graph.yml
- *
- * Usage: node tooling/generate-registry.js
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import yaml from 'js-yaml';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-const SKILLS_DIR = path.join(__dirname, '../.agents/skills');
-const INDEX_FILE = path.join(__dirname, '../.agents/registry/skills-index.yml');
-const GRAPH_FILE = path.join(__dirname, '../.agents/registry/capability-graph.yml');
-
-function parseFrontmatter(content) {
-  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!match) return null;
-  
-  try {
-    return yaml.load(match[1]);
-  } catch (e) {
-    console.error('YAML parse error:', e.message);
-    return null;
-  }
-}
-
-function generate() {
-  const skills = [];
-
-  if (!fs.existsSync(SKILLS_DIR)) {
-    console.error('Skills directory not found:', SKILLS_DIR);
-    process.exit(1);
-  }
-
-  const skillDirs = fs.readdirSync(SKILLS_DIR)
-    .filter(d => !d.startsWith('_') && fs.statSync(path.join(SKILLS_DIR, d)).isDirectory());
-
-  for (const dir of skillDirs) {
-    const skillFile = path.join(SKILLS_DIR, dir, 'SKILL.md');
-    if (!fs.existsSync(skillFile)) continue;
-
-    const content = fs.readFileSync(skillFile, 'utf8');
-    const meta = parseFrontmatter(content);
-    if (!meta || !meta.name) continue;
-
-    // Default legacy if not marked stable
-    if (!meta.status && meta.version && meta.version.startsWith('8.')) {
-        meta.status = 'stable';
-    }
-
-    // Schema Validation Enforcement
-    if (meta.status === 'stable' && meta.version && meta.version.startsWith('8.')) {
-      if (!meta.intent || !meta.workflow || !meta.verification || !meta.selection) {
-        console.warn(`[WARN] Rejecting ${meta.name} (v8): Missing required schema fields`);
-        continue;
-      }
-    }
-
-    skills.push(meta);
-  }
-
-  // 1. Generate skills-index.yml (Backward compatibility)
-  const indexData = {
-    version: "8.1.1",
-    generated_at: new Date().toISOString(),
-    total_skills: skills.length,
-    skills: skills.map(s => ({
-      name: s.name,
-      version: s.version || "8.0.0",
-      status: s.status || "legacy",
-      description: s.description || "",
-      complexity: s.complexity?.level || "medium",
-      workflow: s.workflow || null,
-      triggers: s.triggers || [],
-      intent: s.intent || []
-    }))
-  };
-
-  fs.mkdirSync(path.dirname(INDEX_FILE), { recursive: true });
-  fs.writeFileSync(INDEX_FILE, `# registry/skills-index.yml\n# GENERATED FILE — DO NOT EDIT MANUALLY\n` + yaml.dump(indexData, { indent: 2 }), 'utf8');
-
-  // 2. Generate capability-graph.yml (V8.1.1)
-  const nodes = {};
-  const edges = [];
-
-  for (const s of skills) {
-    nodes[s.name] = {
-      type: s.type || 'capability',
-      maturity: s.status || 'legacy',
-      owns: s.decision_boundary?.owns || [],
-      does_not_own: s.decision_boundary?.does_not_own || [],
-      conflicts: s.decision_boundary?.conflicts_with || [],
-      workflow: s.workflow || null
-    };
-
-    if (s.workflow) {
-      edges.push({
-        from: s.name,
-        to: s.workflow,
-        relation: 'depends_on'
-      });
-    }
-    
-    if (s.decision_boundary?.conflicts_with) {
-      for (const conflict of s.decision_boundary.conflicts_with) {
-        edges.push({
-          from: s.name,
-          to: conflict,
-          relation: 'conflicts_with'
-        });
-      }
-    }
-    
-    if (s.decision_boundary?.delegates_to) {
-      for (const delegate of s.decision_boundary.delegates_to) {
-        edges.push({
-          from: s.name,
-          to: delegate,
-          relation: 'delegates_to'
-        });
-        // Derive reverse relation 'implemented_by'
-        edges.push({
-          from: delegate,
-          to: s.name,
-          relation: 'implemented_by'
-        });
-      }
-    }
-    
-    if (s.related_skills) {
-       for (const related of s.related_skills) {
-         edges.push({
-           from: s.name,
-           to: related,
-           relation: 'feeds'
-         });
-       }
-    }
-  }
-
-  const graphData = {
-    version: "8.1.3",
-    generated_at: new Date().toISOString(),
-    nodes,
-    edges
-  };
-
-  fs.writeFileSync(GRAPH_FILE, `# registry/capability-graph.yml\n# GENERATED FILE — DO NOT EDIT MANUALLY\n` + yaml.dump(graphData, { indent: 2 }), 'utf8');
-
-  console.log(`✅ Generated registry index and capability graph with ${skills.length} skills`);
-}
-
-generate();