# Engineering Capacity OS Workflow Report System

Version: 3.0

The report system converts answer cards into executive operating reports. A report should tell a CTO, CIO, or VP Engineering what the system is doing, what evidence supports that view, where confidence is weak, and what can be changed safely.

## Required Report Sections

- Operating decision
- Evidence boundary
- Answer cards
- System diagnosis
- Confidence table
- Missing instrumentation
- Risk register
- Recommended next safe actions
- Human approval and rollback boundary

## Forbidden Report Sections

- Raw source code
- Secrets or credentials
- Customer records
- Private employee records
- Unredacted logs
- Payroll, legal, or health data
- Forced recommendation without evidence

## Report Types

### Engineering Capacity OS Diagnostic

Schema node: `engineering_capacity_os_diagnostic`

Executive view of capacity, topology, telemetry, governance, and AI readiness.

Primary domains:
- capacity_intelligence
- decision_grade_telemetry
- governance_security_failure_modes

Output questions:
- What is the actual constraint?
- What evidence supports that conclusion?
- Can the system absorb more capacity?
- Where is instrumentation missing?

### Capacity Topology Readiness Report

Schema node: `capacity_topology_readiness_report`

Decision support for internal hiring, distributed teams, external partners, nearshore, offshore, platform investment, or agentic workflows.

Primary domains:
- distributed_capacity_topology
- knowledge_architecture_memory
- execution_harness

Output questions:
- Which workstreams are distributable?
- Which workstreams should remain internally owned?
- What controls must exist before the topology changes?
- Where would the model create hidden risk?

### Agentic SDLC Readiness Report

Schema node: `agentic_sdlc_readiness_report`

Assessment of which engineering workflows can be safely delegated to agents.

Primary domains:
- governed_agentic_sdlc
- governed_adaptive_control_loops
- governance_security_failure_modes

Output questions:
- Which tasks are safe for agent assistance?
- Where is human judgment still required?
- What telemetry proves agents are helping?
- What approval, audit, and rollback controls are required?

### Execution Control Plane Report

Schema node: `execution_control_plane_report`

Review of CI/CD, deployment, environment, rollback, quality-gate, and workflow determinism.

Primary domains:
- execution_harness
- decision_grade_telemetry
- governance_security_failure_modes

Output questions:
- Where does execution variance enter the SDLC?
- Which controls are manually enforced?
- Which controls are system-enforced?
- How reproducible are deployments across environments?