Changelog

2026-03-09 - Add Synthetic Monitoring to Testing Glossary

Added Synthetic Monitoring definition to the Testing Glossary.

2026-03-09 - Testing Section Moved to Top-Level, Renamed “Architecting Tests for CD”

Moved the Testing section from /docs/reference/testing/ to /docs/testing/ as a peer of the Reference section, renamed to Architecting Tests for CD. All old URLs redirect via Hugo aliases. Updated all cross-references across the site.

2026-03-09 - Contract Testing: Consumer/Provider and CDC vs. Contract-First

Expanded Contract Tests to cover:

• Consumer contract testing - what the consumer is trying to discover (fields I depend on, types, status codes)
• Provider contract testing - what the provider is trying to discover (breaking changes to any consumer)
• Consumer-driven contract development (CDC) - consumers write expectations, providers verify against them
• Contract-first development - contracts defined upfront as formal artifacts (OpenAPI, Protobuf), teams develop in parallel
• Guidance on when to prefer each approach

2026-03-09 - Testing Taxonomy: E2E Absorbs Integration, Integration Forwarding Page

• End-to-End Tests now covers the full spectrum of tests involving real external dependencies - from two services with a real database to a full-system browser test. Notes that this is also called “integration testing” in the industry, with a terminology section explaining the naming landscape.
• Added Integration Tests as a terminology forwarding page explaining where different uses of “integration test” map in this site’s taxonomy.

2026-03-09 - Testing Taxonomy: Component Tests, Integration Test Redefinition

Restructured the testing reference section with a clearer taxonomy:

• Added Component Tests - a new test type covering frontend components and backend services tested through their public interface with test doubles for all external dependencies. Absorbs and replaces the former Functional Tests page (old URL redirects automatically).
• Redefined Integration Tests to mean tests against real external dependencies (actual databases, live downstream services) in a controlled environment. Documents the complexity this brings: test data management, non-determinism risks, slower execution, and environment availability. Integration tests only belong in the pipeline if they can be kept deterministic.
• Updated Unit Tests to clarify the solitary vs. sociable distinction.
• Added Exploratory Testing and Usability Testing to the architecture table as non-blocking activities.
• Added Component Test, Integration Test, Sociable Unit Test, and Solitary Unit Test entries to the Testing Glossary.

2026-03-07 - Agentic CD Glossary Split

• Moved 30 AI and agentic-specific terms from the main glossary into a dedicated Agentic CD Glossary.
• Main glossary retains stub entries that redirect to the new glossary for each moved term.

2026-03-06 - Testing Fundamentals Restructured into Subsection

• Restructured Testing Fundamentals from a single long page into a subsection with four focused child pages: What to Test, Pipeline Test Strategy, Getting Started, and Defect Feedback Loop.
• Added four SVG diagrams to Pipeline Test Strategy showing tests inside the pipeline, tests outside the pipeline, the contract test validation loop, and the full pipeline test architecture.

2026-03-06 - Repository Readiness for Agentic Development

• Added Repository Readiness - a new getting-started page covering readiness scoring, upgrade sequence, agent-friendly test structure, build ergonomics, and the link between repository quality and agent accuracy/token efficiency.

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: