V0.6.0 -- Expanded Governance & AI Skills Engine

Changelog V0.6.0 (2026-05-26)

[V0.6.0] — Expanded Governance & AI Skills Engine

This minor release introduces comprehensive, pure-markdown governance extensions to the FrameCode VibeWork framework, adding specialized environment and performance controls, JIT onboarding and compaction skills, and a dedicated Technical Debt and Refactoring Ledger, in strict alignment with ADR-0001.

---

Added

• FCVW/ENVIRONMENT.md: Governs configurations, .env.example compliance, API mock redirections, and secure local/staging/production credential segregation.
• FCVW/governance/TEMPLATE_ENV.md: Reusable environment configuration and secrets setup blueprint for downstream projects.
• FCVW/PERFORMANCE.md: Establishes objective performance thresholds (Core Web Vitals budgets, gzipped bundles limit, caching guidelines) for visual elements and APIs.
• FCVW/governance/TEMPLATE_API_SPEC.md: Structured Markdown contract template to formalize API payloads and route signatures, mitigating API drift.
• FCVW/skills/aicc-compact/SKILL.md: JIT active skill instructing the agent on performing compact, low-overhead session syntheses (S*.md) at shift closures.
• FCVW/skills/project-instantiation/SKILL.md: JIT active skill mapping bootstrap workflows and placeholder replacements for Phase 0 setup.
• FCVW/wiki/templates/TEMPLATE_TECH_DEBT.md: Reusable card structure for Obsidian wiki indexing to log technical shortcuts and code smells.

---

Modified

• FCVW/REFACTORING.md: Integrated section 24. Technical Debt & Refactoring Ledger to formalize tracing and paying down #tech-debt cards inside refactoring change plans.
• FCVW/MANIFEST.md: Registered version increment to V0.6.0, listed all new documents and templates in official files registries, and recorded release history.
• FCVW/CONTEXT_MAP.md: Calibrated selective context tables to load performance and environment documents correctly and added new skills to JIT catalogs.
• FCVW/skills/README.md: Cataloged aicc-compact and project-instantiation active skills in Portuguese and English.
• FCVW/FILESYSTEM.md: Expanded declarative repository tree layout with all V0.6.0 files.
• FCVW/README.md & README.md: Harmonized visual structures inside framework and root READMEs to reflect the new layout.
• FCVW/docs/index.html: Updated HTML documentation tables and version badge in all 4 languages.
• AGENTS.md: Updated agent instructions and load-priority directories.

---

Verification and Compliance

• Link Checking: Manual audit of all relative links between governance files confirmed zero broken links.
• Obsidian Graph: verified Markdown frontmatter syntax on all new pages and templates for smooth vault compilation.
• Pure-Markdown Model: Zero scripts or compiled packages were introduced, preserving 100% stack-agnostic portability.

V0.5.0

Changelog V0.5.0

Version

V0.5.0

Date

2026-05-22

Release Status

published

Release Type

minor

Summary

• Filled all placeholder fields in key framework documents and synchronized V0.5.0 narrative across governance sources.
• Expanded the AI Skills Engine (ASE) from 1 to 4 active skills and introduced selective loading guidance via CONTEXT_MAP.md.
• Promoted reusable knowledge to the wiki (patterns, decision synthesis, release synthesis) and fixed session/frontmatter consistency.
• Performed cross-repository portability normalization by replacing local absolute markdown links with repository-relative links.
• Finalized release governance with security pre-push scanning, annotated tag publication, and GitHub release creation.

Related Plans

• Plans/completed/P2-R2-2026-05-22-framework-optimization-and-ase-expansion.md
• Plans/completed/P3-R1-2026-05-22-readme-and-stack-sync-v0.5.0.md
• Plans/completed/P2-R2-2026-05-22-fix-governance-consistency-v0-5-0.md
• Plans/completed/P2-R2-2026-05-22-publish-v0-5-0.md

Items Modified

• Core governance docs: AGENTS.md, AI.md, MANIFEST.md, README.md, SCOPE.md, STACK.md, TROUBLESHOOTING.md, FILESYSTEM.md
• New selective-loading map: CONTEXT_MAP.md (created)
• Skills catalog and new skills:
  • skills/README.md
  • skills/git-conventional-commits/SKILL.md (created)
  • skills/wiki-lint/SKILL.md (created)
  • skills/release-checklist/SKILL.md (created)
• Governance templates:
  • governance/TEMPLATE_AI_SESSION_SYNTHESIS.md
  • governance/TEMPLATE_TROUBLESHOOTING.md (created)
  • wiki/templates/TEMPLATE_SESSION_SYNTHESIS.md
• Wiki updates:
  • wiki/index.md
  • wiki/log.md
  • wiki/syntheses/S005-framework-optimization-analysis.md
  • wiki/decisions/adr-0001-pure-markdown.md (created)
  • wiki/patterns/aicc-session-compression.md (created)
  • wiki/patterns/ase-jit-skill-loading.md (created)
  • wiki/releases/v0-4-0.md (created)
  • wiki/releases/v0-5-0.md (created)
  • wiki/sessions/S001-2026-05-18-ai-context-compression-implementation.md
  • wiki/sessions/S002-2026-05-18-integrate-token-estimations.md
  • wiki/sessions/S003-2026-05-18-implement-skills-engine.md
  • wiki/sessions/S004-2026-05-18-align-readme-directory-trees.md
  • wiki/sessions/S006-2026-05-18-discontinue-mockups-and-automation-scripts.md
  • wiki/sessions/S007-2026-05-22-framework-optimization-and-ase-expansion.md (created)
  • wiki/sessions/S008-2026-05-22-publish-v0-5-0-release.md (created)
• Plan lifecycle updates:
  • Plans/completed/P1-R2-2026-05-17-repo-internationalization.md (moved from in_progress, status finalized)
  • Plans/completed/P2-R2-2026-05-22-framework-optimization-and-ase-expansion.md (created then completed)
  • Plans/completed/P3-R1-2026-05-22-readme-and-stack-sync-v0.5.0.md (created then completed)
  • Plans/completed/P2-R2-2026-05-22-fix-governance-consistency-v0-5-0.md (created then completed)
  • Plans/completed/P2-R2-2026-05-22-publish-v0-5-0.md (created then completed)
  • Plans/discontinued/P2-R2-2026-05-22-publish-v0.4.0.md (created then discontinued)
• Historical portability fixes touched these already-versioned records:
  • Plans/completed/P3-R1-2026-05-18-token-estimations-readme-integration.md
  • Plans/completed/P3-R1-2026-05-18-update-readme-directory-trees.md
  • Plans/completed/P3-R2-2026-05-18-ai-context-compression-implementation.md
  • Plans/completed/P3-R2-2026-05-18-skills-engine-and-obsidian-markdown-integration.md
  • Plans/completed/P4-R2-2026-05-18-discontinue-mockups-and-automation-scripts.md
  • changelogs/V0.2.1.md
  • changelogs/V0.3.0.md
  • changelogs/V0.3.1.md

Justifications

• Placeholder/template leftovers and stale operational states reduced governance reliability.
• Wiki broken links and malformed frontmatter reduced retrievability and parser compatibility.
• Absolute local paths harmed portability in a public template repository.
• Release publication required explicit credential-leak safeguards due public visibility.

Validation Executed

• Secret-pattern scan executed across repository content with zero credential-like findings.
• .env and .env.* remain excluded by .gitignore (!.env.example preserved).
• Markdown link check passed (BrokenMarkdownLinks=0 under project checks).
• Wiki wikilink check passed (BrokenWikilinks=0 for non-template wiki pages).
• Session frontmatter checks passed for S001-S004 and S006 with session_number fields.
• Release publication checks passed: commit created, tag v0.5.0 created, tag pushed, GitHub release created.

v0.4.0 - Pure Markdown Instruction Model (ADR-0001)

FrameCode VibeWork v0.4.0 - Minor Release

This minor release implements the architectural transition to a Pure Markdown Instruction Model (ADR-0001), deprecating external shell script dependencies and structural mockup visual folders in favor of robust declarative files.

Key Changes:

• +ADR-0001 Adopted*: Transitioned the framework to a pure declarative Markdown model.
• Mockups Deprecated: Physically removed the mockups/ folder. All visual guidelines and comparison mechanisms are now natively consolidated inside a robust DESIGN.md.
• PowerShell Scripts Deprecated: Deleted sync-filesystem.ps1. Visual project structures are declared and maintained manually inside FILESYSTEM.md and README.md.
• Pruned Operational Checklists: Removed script execution triggers and mockup requirements from all instructions.
• Version Bumps: Incremented framework baseline to V0.4.0 across Stack and Manifest records.