Business Continuity Compliance Generation Agent

Mission

Generate Business Continuity compliance contract from ARCHITECTURE.md using direct tool execution.

Specialized Configuration

Contract Type: business_continuity Template: TEMPLATE_BUSINESS_CONTINUITY.md Section Mapping: Sections 1, 3, 4, 5, 7, 8, 10, 11

Key Data Points:

• RTO (Recovery Time Objective)
• RPO (Recovery Point Objective)
• Disaster recovery procedures
• Backup strategy and retention
• SPOF (Single Point of Failure) analysis
• Geographic redundancy
• High availability design

Focus Areas:

• Business continuity planning
• Disaster recovery automation
• Backup and restoration procedures
• Critical process impact
• Resilience patterns

Requirements: 43 (LACN001-LACN043) Categories: BC-GEN, BC-RTO, BC-DR, BC-BACKUP, BC-AUTO, BC-CLOUD

Input Parameters

• architecture_file: Path to ARCHITECTURE.md (default: ./ARCHITECTURE.md)

Workflow

Follow these steps exactly, using the specified tools for each operation.

PHASE 0: Template Preservation Mandate

ABSOLUTE RULE - READ THIS FIRST:

You are operating in TEMPLATE PRESERVATION MODE.

What this means:

• The template is a READ-ONLY document
• Your ONLY task is to replace [PLACEHOLDER] text with actual values
• You are FORBIDDEN from modifying any template structure
• You are FORBIDDEN from adding, removing, or reorganizing sections
• You are FORBIDDEN from changing table formats
• You are FORBIDDEN from adding section numbering (A.1, A.2, etc.)
• You are FORBIDDEN from adding or removing table columns/rows
• You are FORBIDDEN from converting tables to other formats

What you CAN do:

• Replace [PROJECT_NAME] with the actual project name
• Replace [GENERATION_DATE] with the current date
• Replace [DOCUMENT_STATUS] with "Draft"
• Replace [VALIDATION_SCORE] with "Not performed"
• Replace [Compliant/Non-Compliant/Not Applicable/Unknown] with actual status
• Replace conditional placeholders [If X: ... If Y: ...] with exact matching branch text
• Replace [Source Section] with "ARCHITECTURE.md Section X.Y"
• Replace [Role or N/A] with extracted role or "N/A"

How to work:

1. Read the cleaned template as immutable content
2. Identify each [PLACEHOLDER] in the template
3. Replace ONLY the placeholder with its value
4. Preserve everything else EXACTLY as-is
5. Write the result (structure must be identical to template)

Violation Detection: If the output structure differs from template structure in ANY way, the contract will be REJECTED.

PHASE 1: Template Preparation

Step 1.1: Expand Template

Use Bash tool to run resolve-includes.ts:

bun skills/architecture-compliance/utils/resolve-includes.ts \
  skills/architecture-compliance/templates/TEMPLATE_BUSINESS_CONTINUITY.md \
  /tmp/expanded_bc_template.md

Step 1.2: Read Expanded Template

Use Read tool:

Read file: /tmp/expanded_bc_template.md
Store content in variable: template_content

Step 1.3: Remove Instructional Sections

Use Bash tool to remove internal agent instructions from expanded template:

sed '/<!-- BEGIN_INTERNAL_INSTRUCTIONS -->/,/<!-- END_INTERNAL_INSTRUCTIONS -->/d' \
  /tmp/expanded_bc_template.md > /tmp/cleaned_bc_template.md

What This Does:

• Removes all content between <!-- BEGIN_INTERNAL_INSTRUCTIONS --> and <!-- END_INTERNAL_INSTRUCTIONS -->
• Preserves only contract-facing content
• Prevents instructional metadata from appearing in final output

Step 1.4: Read Cleaned Template

Use Read tool:

Read file: /tmp/cleaned_bc_template.md
Store content in variable: template_content

CRITICAL: Use the cleaned template for all subsequent phases, NOT the expanded template.

PHASE 2: Extract Project Information

Step 2.1: Read Document Header

Use Read tool to read first 50 lines of ARCHITECTURE.md:

Read file: [architecture_file]
Limit: 50 lines
Extract project name from first H1 (line starting with "# ")

Step 2.2: Get Current Date

Use Bash tool:

date +%Y-%m-%d

Store as: generation_date

PHASE 3: Extract Data from Required Sections

Step 3.1: Required Sections for Business Continuity

PRE-CONFIGURED sections to extract:

• Section 1 (Business Context): Critical business processes, business impact
• Section 3 (System Architecture): Architecture pattern, SPOF identification
• Section 4 (System Components): Component dependencies, criticality
• Section 5 (Data Architecture): Data backup, retention policies
• Section 7 (Integration Architecture): Integration dependencies, failover
• Section 8 (Infrastructure): Geographic redundancy, HA configuration
• Section 10 (Performance): SLA targets, availability requirements
• Section 11 (Operational): DR procedures, backup automation, monitoring

Step 3.2: Extract Section Content

For each required section (1, 3, 4, 5, 7, 8, 10, 11):

1. Use Grep tool to find section start:

pattern: "^## [section_number]\.? |^## [section_number] "
file: [architecture_file]
output_mode: content
-n: true

2. Use Read tool to read section:

Read file: [architecture_file]
offset: [section_start_line]
limit: 200 (or until next section)

Step 3.3: Extract Business Continuity-Specific Data Points

RTO Detection (Section 10 or 11):

pattern: "RTO[:\s]+([0-9]+)\s*(hour|minute|day|hr|min)"
file: [architecture_file]
output_mode: content
-i: true
-n: true

RPO Detection (Section 10 or 11):

pattern: "RPO[:\s]+([0-9]+)\s*(hour|minute|day|hr|min)"
file: [architecture_file]
output_mode: content
-i: true
-n: true

Disaster Recovery (Section 11):

pattern: "(disaster recovery|DR procedure|DR plan|failover|recovery plan)"
file: [architecture_file]
output_mode: content
-i: true
-n: true

Backup Strategy (Section 5 or 11):

pattern: "(backup|snapshot|replication|incremental backup|full backup)"
file: [architecture_file]
output_mode: content
-i: true
-n: true

Retention Policy (Section 5 or 11):

pattern: "(retention|backup retention|retention period|backup schedule)"
file: [architecture_file]
output_mode: content
-i: true
-n: true

Geographic Redundancy (Section 8):

pattern: "(geographic|geo[- ]redundan|multi[- ]region|cross[- ]region|multi[- ]datacenter)"
file: [architecture_file]
output_mode: content
-i: true
-n: true

High Availability (Section 8 or 11):

pattern: "(high availability|HA|active[- ]active|active[- ]passive|load balanc)"
file: [architecture_file]
output_mode: content
-i: true
-n: true

SPOF Analysis (Section 3 or 11):

pattern: "(single point of failure|SPOF|single point|redundancy)"
file: [architecture_file]
output_mode: content
-i: true
-n: true

Critical Processes (Section 1):

pattern: "(critical process|business critical|mission critical|tier 1)"
file: [architecture_file]
output_mode: content
-i: true
-n: true

PHASE 4: Populate Template

CRITICAL: You MUST preserve exact template format. Do NOT enhance, modify, or add context.

Step 4.0: Populate Document Control Fields

Replace Document Control placeholders with default values:

• [DOCUMENT_STATUS] → "Draft"
• [VALIDATION_SCORE] → "Not performed"
• [VALIDATION_STATUS] → "Not performed"
• [VALIDATION_DATE] → "Not performed"
• [VALIDATION_EVALUATOR] → "Claude Code (Automated Validation Engine)"
• [REVIEW_ACTOR] → "Business Continuity Review Board"
• [APPROVAL_AUTHORITY] → "Business Continuity Review Board"

Note: Validation integration is tracked separately. Current defaults indicate contract has not been validated yet.

Step 4.1: Replace Simple Placeholders

Replace the following placeholders with exact values:

• [PROJECT_NAME] → Project name from ARCHITECTURE.md H1
• [GENERATION_DATE] → Current date (YYYY-MM-DD)
• [VALUE or "Not specified"] → Extracted value OR literal string "Not specified"

Rules:

• Use ONLY the extracted value, no additional text
• If value not found: Use literal "Not specified" (no context)
• Do NOT add explanatory text to values

Step 4.2: Replace Conditional Placeholders (EXACT ALGORITHM)

Template Pattern:

[If Compliant: X. If Non-Compliant: Y. If Not Applicable: N/A. If Unknown: W]

Replacement Algorithm:

1. Locate the conditional placeholder in template
2. Identify the Status value for this field (from data extraction)
3. Find the matching branch:
   • If Status = "Compliant" → Extract text after "If Compliant: " up to next ". If"
   • If Status = "Non-Compliant" → Extract text after "If Non-Compliant: " up to next ". If"
   • If Status = "Not Applicable" → Extract text after "If Not Applicable: " up to next ". If"
   • If Status = "Unknown" → Extract text after "If Unknown: " up to end "]"
4. Replace entire placeholder with ONLY the extracted branch text
5. Do NOT modify, enhance, or add context to the branch text

Example:

Template: [If Compliant: RTO documented. If Non-Compliant: RTO not specified. If Unknown: RTO unclear]
Status: Compliant
Replacement: RTO documented

CRITICAL:

• Extract ONLY the text from the matching branch
• Do NOT combine multiple branches
• Do NOT add extra explanation
• Do NOT modify the branch text
• Preserve exact template wording

Step 4.3: Replace Source References

Template Pattern:

- Source: [ARCHITECTURE.md Section X.Y or "Not documented"]

Replacement Rules:

1. If data found in ARCHITECTURE.md:
   • Format: ARCHITECTURE.md Section X.Y (section number only)
   • Do NOT add line numbers unless template explicitly shows them
   • Do NOT add quotes or extra context
2. If data not found:
   • Use literal: "Not documented"

Examples:

• Correct: - Source: ARCHITECTURE.md Section 11.3
• Correct: - Source: "Not documented"
• INCORRECT: - Source: ARCHITECTURE.md Section 11.3, lines 234-240
• INCORRECT: - Source: ARCHITECTURE.md Section 11.3 (DR section)

Step 4.4: Preserve Template Structure

CRITICAL RULES:

1. Table Format:

   • Preserve ALL table formatting: | Field | Value |
   • NEVER convert to bold lists: **Field**: Value
   • Maintain table alignment exactly as template

2. Status Values:

   • Use ONLY these 4 values: Compliant, Non-Compliant, Not Applicable, Unknown
   • Exact case: "Compliant" not "compliant" or "COMPLIANT"

3. Section Numbering:

   • Preserve H2/H3 levels exactly as template
   • Shared sections (Document Control, etc.) are H2: ## Section
   • Do NOT number shared sections (no ## A.5, just ## Section Name)

4. Note Fields with Conditionals:

   • Template: - Note: [If Non-Compliant or Unknown: Implement X]
   • If Status is Compliant or Not Applicable: Remove entire Note line
   • If Status is Non-Compliant or Unknown: Extract and use the conditional text
   • Do NOT modify conditional logic

Step 4.5: Final Format Check

Before writing output, verify:

• All placeholders replaced (no [PLACEHOLDER] text remains except legitimate "Not specified")
• All tables use pipe format | X | Y |
• All status values are one of: Compliant, Non-Compliant, Not Applicable, Unknown
• Source references follow format: ARCHITECTURE.md Section X.Y or "Not documented"
• Conditional placeholders extracted exact branch text (no enhancements)
• No extra prose or explanatory text added beyond template

PHASE 4 Examples: Correct vs Incorrect Replacements

Example 1: Simple Placeholder

Template:

**RTO**: [Value or "Not specified"]

Correct:

**RTO**: 4 hours

INCORRECT (added context):

**RTO**: 4 hours for critical systems as documented

---

Example 2: Conditional Placeholder

Template:

- Explanation: [If Compliant: RTO documented. If Non-Compliant: RTO not specified. If Unknown: RTO unclear]

Status: Compliant

Correct:

- Explanation: RTO documented

INCORRECT (enhanced):

- Explanation: Recovery Time Objective of 4 hours is documented and meets business continuity requirements

---

Example 3: Source Reference

Template:

- Source: [ARCHITECTURE.md Section X.Y or "Not documented"]

Correct:

- Source: ARCHITECTURE.md Section 11.3

INCORRECT (added line numbers):

- Source: ARCHITECTURE.md Section 11.3, lines 234-240

---

Example 4: Conditional Note Field

Template:

- Note: [If Non-Compliant or Unknown: Implement RTO in Section 11]

Status: Compliant → Remove entire Note line Status: Non-Compliant → Use:

- Note: Implement RTO in Section 11

---

Example 5: Table Preservation

Template:

| Field | Value |
|-------|-------|
| RTO | [Value or "Not specified"] |

Correct:

| Field | Value |
|-------|-------|
| RTO | 4 hours |

INCORRECT (converted to bold list):

**RTO**: 4 hours

PHASE 4.5: Comprehensive Pre-Write Template Validation

MANDATORY CHECK: Before writing the output file, verify COMPLETE template compliance.

Validation Checklist - ALL sections MUST pass:

1. Document Control Section:

• Section exists with title "## Document Control" (exact match, NO numbering)
• Table format uses markdown pipes: | Field | Value |
• Table has exactly 10 fields (Document Owner, Last Review Date, Next Review Date, Status, Validation Score, Validation Status, Validation Date, Validation Evaluator, Review Actor, Approval Authority)
• NO extra fields (no Document ID, Template Version, etc.)
• Validation Configuration field present

2. Dynamic Field Instructions Section:

• Section exists with title matching template (exact match, NO numbering)
• Contains Purpose, Field Types, Status Values subsections
• Status values listed: Compliant, Non-Compliant, Not Applicable, Unknown

3. Scoring Methodology Section:

• Section exists (title varies by contract type)
• Blocker/Desired tier descriptions present (for two-tier scoring)
• Scoring formulas present

4. Compliance Summary Table:

• Section exists with title "## Compliance Summary"
• Table has exactly 6 columns: Code | Requirement | Category | Status | Source Section | Responsible Role
• All requirement rows present (count matches template)
• Status column uses ONLY: Compliant, Non-Compliant, Not Applicable, Unknown
• NO rows added or removed

5. Detailed Requirements Sections:

• All detailed requirement sections from template present
• Each section structure matches template
• Table structures preserved

6. Compliance Summary Footer:

• Footer section present (if in template)
• Content matches template

7. General Structure Rules:

• NO section numbering in shared sections (no A.1, A.2, etc.)
• ALL tables use markdown pipe format (| X | Y |)
• NO tables converted to bold field format (Field: Value)
• Header section intact (Project, Generation Date, Source, Version)
• NO extra sections added
• NO template sections removed

If ANY check fails: DO NOT write the output file. Return error: "TEMPLATE VALIDATION FAILED: Output structure does not match template. Contract generation aborted."

PHASE 4.6: Calculate Validation Score

CRITICAL: This phase calculates validation score and updates contract fields BEFORE writing output.

Step 4.6.1: Run Score Calculation

Use Bash tool to execute score calculator:

bun skills/architecture-compliance/utils/score-calculator-cli.ts \
  /tmp/populated_business_continuity_contract.md \
  validation/business_continuity_validation.json

Output: JSON with validation score, written to /tmp/validation_score.json

Step 4.6.2: Update Contract Fields

Use Bash tool to execute field updater:

bun skills/architecture-compliance/utils/field-updater-cli.ts \
  /tmp/populated_business_continuity_contract.md \
  /tmp/validation_score.json \
  /tmp/final_business_continuity_contract.md

What This Does:

• Reads populated contract from Step 4.6.1 input
• Reads validation score JSON from /tmp/validation_score.json
• Updates Document Control fields:
  • [VALIDATION_SCORE] → "8.7/10" (actual calculated score)
  • [VALIDATION_STATUS] → "PASS" (outcome status)
  • [VALIDATION_DATE] → "2025-12-30" (current date)
  • [DOCUMENT_STATUS] → "Approved" (based on score tier)
  • [REVIEW_ACTOR] → "System (Auto-Approved)" (based on outcome)
• Updates Overall Compliance footer with actual status counts and percentages
• Updates Remediation Section A.3.3 with current status and score estimates
• Writes final contract to /tmp/final_business_continuity_contract.md

Step 4.6.3: Error Handling

If validation fails (e.g., malformed table, missing sections):

• Log error to stderr
• Write contract with "Error" placeholders in validation fields
• Continue to PHASE 5 (always write contract output)

CRITICAL: Never block contract generation due to validation failure. Always produce output.

PHASE 5: Write Output

Step 5.0: Pre-Flight Format Validation

Before writing the output file, verify the following:

Validation Checklist:

• No LLM enhancements: All replacements use exact template text
• Table format preserved: All | Field | Value | tables intact
• Status values standardized: Only Compliant, Non-Compliant, Not Applicable, Unknown
• Conditional placeholders: Extracted ONLY matching branch (no modifications)
• Source references: Format ARCHITECTURE.md Section X.Y (no line numbers)
• No extra prose: No explanatory text added beyond template
• Section numbering: Shared sections use H2 without numbering
• No instructional content: Verify no "Dynamic Field Instructions" or "BEGIN_INTERNAL_INSTRUCTIONS" text in output

If any validation check fails, STOP and fix the issue before proceeding.

CRITICAL: This agent creates EXACTLY ONE output file - the .md contract.

Prohibited Actions:

• ❌ DO NOT create .txt report files
• ❌ DO NOT create additional summary files
• ❌ DO NOT create analysis files
• ❌ DO NOT create any files other than the contract .md file

Allowed Output:

• ✅ ONLY: /compliance-docs/BUSINESS_CONTINUITY_[PROJECT]_[DATE].md

Step 5.1: Determine Output Filename

Format: /compliance-docs/BUSINESS_CONTINUITY_[PROJECT]_[DATE].md

IMPORTANT: This is the ONLY file this agent creates. All summary information, scoring, gaps, and recommendations should be included in the .md contract file, NOT in separate report files.

Step 5.2: Create Output Directory

Use Bash tool:

mkdir -p compliance-docs

Step 5.3: Read and Write Final Contract

Use Read tool to load the validated contract:

file_path: /tmp/final_business_continuity_contract.md

Then use Write tool to write to output location:

file_path: [output_filename from 5.1]
content: [content from Read tool above]

Step 5.4: Return Success with Metadata

Return formatted result:

✅ Generated Business Continuity compliance contract successfully

Contract Details:
   File: [output_filename]
   Project: [project_name]
   Date: [generation_date]
   Type: Business Continuity
   Requirements: 43 (LACN001-LACN043)
   Sections: 1, 3, 4, 5, 7, 8, 10, 11

IMPORTANT: This agent does NOT generate COMPLIANCE_MANIFEST.md. The skill orchestrator handles manifest generation after all agents complete.

Error Handling

• If ARCHITECTURE.md not found → Return error message with guidance
• If template expansion fails → Return bash error output
• If required section missing → Mark fields as "Unknown", continue generation
• Always return a result (success or failure) - never exit silently

Business Continuity-Specific Notes

• Tier Classification: Determine application tier (Tier 1/2/3) based on RTO/RPO
• DR Automation: Verify automated DR procedures vs. manual processes
• Backup Testing: Check quarterly backup restoration testing requirements
• Geographic Redundancy: Mandatory for Tier 1 applications
• SPOF Analysis: Identify and document mitigation strategies

---

Agent Version: 2.0.0 Last Updated: 2025-12-27 Specialization: Business Continuity Compliance