Changelog

2026-03-03 - AI Tech Debt: Layered Detection and Stage 5 Spec References

• Updated AI Is Generating Technical Debt Faster Than the Team Can Absorb It to describe the two-layer approach for automated structural quality detection: deterministic tools (duplication detection, complexity limits, architecture rules) as the first layer and the semantic review agent with architectural constraints as the second layer.
• Fixed Stage 5 in The Agentic Development Learning Curve to reference Agent-Assisted Specification and Agent Delivery Contract directly from the spec-first workflow description.
• Fixed placeholder /docs/ links across all Agentic CD pages to point to the correct destinations.

2026-03-03 - New Triage Problems: AI Coding and Test Environment Reset

Added four new triage problems with supporting content:

• AI-Generated Code Ships Without Developer Understanding - new symptom page for teams where AI output ships without critical review
• Rubber-Stamping AI-Generated Code - new anti-pattern with fix steps for establishing review standards for AI output
• AI Tooling Slows You Down Instead of Speeding You Up - new symptom page for teams where AI tools add overhead instead of reducing it
• Test Environments Take Too Long to Reset Between Runs - new symptom page for slow environment and database reset blocking regression testing
• AI Is Generating Technical Debt Faster Than the Team Can Absorb It - new symptom page for AI-generated structural drift, tied to agentic-cd refactoring guidance

Updated the triage page with entries for all five problems, including a pointer to existing content for developer assignment to unfamiliar components.

2026-03-03 - Glossary: Dependency and External Dependency

Added Dependency and External Dependency definitions to the glossary, clarifying the distinction between internal and external dependencies and when test doubles are appropriate.

2026-03-03 - Site-Wide Restructure for Navigation and Discoverability

Major reorganization to reduce sidebar depth, group related content, and improve discoverability.

Migrate to CD

• Flattened the migration path: removed the intermediate migration-path/ directory so phases (assess, foundations, pipeline, optimize, continuous-deployment) are direct children of Migrate to CD

Symptoms

• Split the 32-page Flow Symptoms section into four subcategories: Integration, Work Management, Developer Experience, and Team Knowledge

Anti-Patterns

• Split the 26 Organizational-Cultural anti-patterns into three subcategories: Governance & Process, Team Dynamics, and Planning

Reference Section

• Created a new Reference section consolidating practices, metrics, testing, pipeline reference architecture, defect sources, glossary, FAQ, DORA capabilities, dependency tree, and resources

Infrastructure

• Converted approximately 4,000 relative links to Hugo relref shortcodes
• Added 100+ permanent redirects for all moved pages
• Updated content-map.yml to reflect new structure
• Added organizational/process category to the triage page
• Simplified the docs landing page to minimal routing
• Removed the a11y CI job (run on demand locally instead)

2026-03-02 - Agentic CD: Sidebar Reorganization

Grouped the 12 flat Agentic CD pages into four subsections for easier navigation:

• Getting Started - configuration, learning curve, prompting disciplines, and adoption roadmap
• Specification & Contracts - agent delivery contract and agent-assisted specification
• Agent Architecture - architecture patterns, coding and review setup, and small-batch sessions
• Operations & Governance - pipeline enforcement, tokenomics, and pitfalls and metrics

All old URLs redirect to their new locations via Hugo aliases.

2026-03-02 - Agentic CD: Prompting Disciplines, Specification Workflow, Terminology Alignment, and Structural Cleanup

New content

• The Four Prompting Disciplines - New page covering the four layers of skill developers must master as AI moves from chat partner to long-running worker: Prompt Craft, Context Engineering, Intent Engineering, and Specification Engineering. Includes the synchronous-to-autonomous skill shift, the self-containment test, the planner-worker architecture, and organizational impact.

• The Discovery Loop - New section in Agent-Assisted Specification describing a four-phase conversational workflow for producing structured specifications: Initial Framing, Deep-Dive Interview, Drafting, and Stress-Test Review.

• Complete Specification Example - Full VSM-Automator specification demonstrating what the discovery loop produces: intent description, feature description, task decomposition, acceptance criteria, and evaluation design.

• Acceptance Criteria - New glossary entry defining acceptance criteria as concrete expectations usable as fitness functions, executed as deterministic tests or evaluated by review agents.

Terminology alignment

Standardized artifact and workflow stage names across the Agentic CD section so the same concepts use the same terms everywhere:

Structural cleanup

Reduced duplication and inconsistency across the Agentic CD section. Content that was restated in multiple pages now has a single authoritative source with cross-references: