Implementation Plan

Implementation

Reference Model

CR-2026-04-15-srt-research-vlan is the reference implementation. Every case study follows this pattern:

  1. Page is a shell — header attributes + include::partial$…​ directives only

  2. Partials hold content — one concern per file

  3. Nav is granular — each partial has its own page and nav entry

  4. Context is tagged — :context: work or :context: personal on every page

Per-Type Partial Patterns

Change Requests (CR-)

partials/case-studies/changes/<slug>/
├── summary.adoc          # Change details, schedule, personnel, scope
├── implementation.adoc   # Technical steps, commands, configs
├── verification.adoc     # Pre/post checklists
├── rollback.adoc         # Backout procedures
└── risk-and-comms.adoc   # Risk table, communication plan, approvals

pages/case-studies/changes/<slug>/
├── index.adoc            # include summary
├── implementation.adoc   # include implementation
├── verification.adoc     # include verification
├── rollback.adoc         # include rollback
└── risk-and-comms.adoc   # include risk-and-comms

Nav pattern:

*** CR: <Title> (<Date>)
**** xref:case-studies/changes/<slug>/index.adoc[Overview]
**** xref:case-studies/changes/<slug>/implementation.adoc[Implementation]
**** xref:case-studies/changes/<slug>/verification.adoc[Verification]
**** xref:case-studies/changes/<slug>/rollback.adoc[Rollback]
**** xref:case-studies/changes/<slug>/risk-and-comms.adoc[Risk & Comms]

Incidents (INC-)

partials/case-studies/incidents/<slug>/
├── summary.adoc          # Severity, timeline, impact, affected systems
├── investigation.adoc    # Symptoms, diagnostics, root cause investigation
├── resolution.adoc       # Fix applied, verification commands
└── prevention.adoc       # Lessons learned, prevention measures, RCA ref

pages/case-studies/incidents/<slug>/
├── index.adoc
├── investigation.adoc
├── resolution.adoc
└── prevention.adoc

Nav pattern:

*** INC: <Title> (<Date>)
**** xref:case-studies/incidents/<slug>/index.adoc[Overview]
**** xref:case-studies/incidents/<slug>/investigation.adoc[Investigation]
**** xref:case-studies/incidents/<slug>/resolution.adoc[Resolution]
**** xref:case-studies/incidents/<slug>/prevention.adoc[Prevention]

Root Cause Analysis (RCA-)

partials/case-studies/rca/<slug>/
├── summary.adoc          # Incident ref, severity, timeline
├── analysis.adoc         # 5 Whys, contributing factors, evidence
├── fix.adoc              # Corrective action, verification
└── prevention.adoc       # Pattern extraction, systemic prevention

pages/case-studies/rca/<slug>/
├── index.adoc
├── analysis.adoc
├── fix.adoc
└── prevention.adoc

Nav pattern:

*** RCA: <Title> (<Date>)
**** xref:case-studies/rca/<slug>/index.adoc[Overview]
**** xref:case-studies/rca/<slug>/analysis.adoc[Analysis]
**** xref:case-studies/rca/<slug>/fix.adoc[Fix]
**** xref:case-studies/rca/<slug>/prevention.adoc[Prevention]

Deployments (DEPLOY-)

partials/case-studies/deployments/<slug>/
├── summary.adoc          # Scope, hardware/software, timeline
├── implementation.adoc   # Phases, commands, configs
├── verification.adoc     # Post-deploy checks
└── issues.adoc           # Issues encountered, workarounds

pages/case-studies/deployments/<slug>/
├── index.adoc
├── implementation.adoc
├── verification.adoc
└── issues.adoc

Nav pattern:

*** DEPLOY: <Title> (<Date>)
**** xref:case-studies/deployments/<slug>/index.adoc[Overview]
**** xref:case-studies/deployments/<slug>/implementation.adoc[Implementation]
**** xref:case-studies/deployments/<slug>/verification.adoc[Verification]
**** xref:case-studies/deployments/<slug>/issues.adoc[Issues]

TAC Cases (TAC-)

partials/case-studies/tac/<slug>/
├── summary.adoc          # Vendor, case#, severity, timeline, contacts
├── investigation.adoc    # TAC findings, logs, analysis, escalations
└── resolution.adoc       # Fix, verification, lessons, vendor feedback

pages/case-studies/tac/<slug>/
├── index.adoc
├── investigation.adoc
└── resolution.adoc

Nav pattern:

*** TAC: <Title> (<Date>)
**** xref:case-studies/tac/<slug>/index.adoc[Overview]
**** xref:case-studies/tac/<slug>/investigation.adoc[Investigation]
**** xref:case-studies/tac/<slug>/resolution.adoc[Resolution]

Page Shell Template

Every page file follows this exact pattern (6 lines):

= Page Title
:description: One-line description
:navtitle: Section Name
:context: work | personal
:icons: font

include::partial$case-studies/<type>/<slug>/<partial>.adoc[]

Execution Process (Per File)

For each monolithic case study:

  1. Read the file — understand the sections and content boundaries

  2. Determine :context: — work or personal based on subject matter

  3. Create partial directory — partials/case-studies/<type>/<slug>/

  4. Split content into partials — one file per concern

  5. Create page directory — pages/case-studies/<type>/<slug>/

  6. Create page shells — one per partial

  7. Delete original monolithic page file

  8. Update nav — replace single entry with granular sub-pages

  9. Build verify — make 2>&1 | grep -E "WARN|ERROR"

  10. Commit — one commit per case study (atomic, reversible)