Skip to content

Commit ce5b3e8

Browse files
committed
docs(profile): publish org vision hub with 13-repo link map
- Add profile/VISION.md: org-audience adaptation of root docs/VISION.md (governed-autonomy thesis, three-plane/SDLC/agent-hierarchy diagrams, proof points, working links to all 13 portfolio repos) - Rewrite profile/README.md as a concise front door: one three-plane Mermaid, link to VISION.md, repo map table (repo -> plane -> one-liner) - Freshness footers per Phase 36 decision 3 Part of Phase 36 documentation refresh (org-dotgithub portion of 36-03).
1 parent 46b4bcf commit ce5b3e8

2 files changed

Lines changed: 199 additions & 147 deletions

File tree

profile/README.md

Lines changed: 66 additions & 147 deletions
Original file line numberDiff line numberDiff line change
@@ -1,136 +1,68 @@
11
# Coding-Autopilot-System
22

3-
> [!TIP]
4-
> Are you an enterprise engineering leader? Read our pitch on **[Why Enterprises Need CAS](ENTERPRISE.md)**.
5-
6-
AI-native engineering portfolio focused on autonomous workflows, prompt governance,
7-
multi-agent execution, and enterprise operating models.
8-
9-
This organization is structured as a small platform, not a random set of demos.
10-
The core story is:
11-
12-
1. install a governed workstation,
13-
2. exchange work through versioned lifecycle contracts,
14-
3. run prompt-aware and agent-aware engineering workflows,
15-
4. deploy through a managed-identity Azure platform,
16-
5. evaluate, observe, validate, and audit what happened.
17-
18-
## Start Here
19-
20-
- **End-to-end reference product**: [cas-reference-product](https://github.com/Coding-Autopilot-System/cas-reference-product)
21-
- **Verified case study**: [immutable golden-path evidence](https://github.com/Coding-Autopilot-System/cas-reference-product/blob/main/docs/case-study-evidence.md)
22-
- **Workstation bootstrap**: [cas-workstation](https://github.com/Coding-Autopilot-System/cas-workstation)
23-
- **Lifecycle contracts**: [cas-contracts](https://github.com/Coding-Autopilot-System/cas-contracts)
24-
- **Azure platform foundation**: [cas-platform](https://github.com/Coding-Autopilot-System/cas-platform)
25-
- **Evaluation evidence**: [cas-evals](https://github.com/Coding-Autopilot-System/cas-evals)
26-
- **Autonomous execution**: [gsd-orchestrator](https://github.com/Coding-Autopilot-System/gsd-orchestrator)
27-
- **Prompt governance**: [Promptimprover](https://github.com/Coding-Autopilot-System/Promptimprover)
28-
- **Multi-agent workbench**: [autogen](https://github.com/Coding-Autopilot-System/autogen)
29-
- **Enterprise architecture depth**: [cloud-security-service-model](https://github.com/Coding-Autopilot-System/cloud-security-service-model)
30-
31-
## Portfolio Map
32-
33-
### End-to-End Proof
34-
35-
#### [cas-reference-product](https://github.com/Coding-Autopilot-System/cas-reference-product)
36-
37-
Production-oriented reference workload that connects the CAS platform story.
38-
39-
- Demonstrates Foundry Next Gen agent integration through a bounded application
40-
interface
41-
- Uses managed identity, canonical lifecycle events, health checks, and
42-
OpenTelemetry boundaries
43-
- Provides the workload contract implemented by `cas-platform` and an executable
44-
local HTTP golden path evaluated by `cas-evals`
45-
- Publishes a [verified case study](https://github.com/Coding-Autopilot-System/cas-reference-product/blob/main/docs/case-study-evidence.md)
46-
backed by an [immutable evidence bundle](https://github.com/Coding-Autopilot-System/cas-reference-product/tree/main/evidence/verified-local-golden-path-v0.1)
47-
48-
### Platform Foundations
49-
50-
#### [cas-contracts](https://github.com/Coding-Autopilot-System/cas-contracts)
51-
52-
Authoritative, versioned lifecycle contracts for the complete CAS workflow.
53-
54-
- Standardizes prompts, policy decisions, work requests, run events, artifacts,
55-
verification, and evaluation
56-
- Requires correlation identifiers and W3C trace context
57-
- Provides executable schemas and compatibility rules
58-
59-
#### [cas-platform](https://github.com/Coding-Autopilot-System/cas-platform)
60-
61-
Secure Azure deployment and observability foundation.
62-
63-
- Uses Bicep, isolated environments, and system-assigned managed identity
64-
- Provides Container Apps hosting, Application Insights, budgets, and safe
65-
non-deploying validation
66-
- Keeps public ingress disabled by default
67-
68-
#### [cas-evals](https://github.com/Coding-Autopilot-System/cas-evals)
69-
70-
Reproducible evaluation and benchmark evidence.
71-
72-
- Runs deterministic golden-task and adversarial-prompt suites
73-
- Measures quality, safety, cost, and latency independently
74-
- Produces machine-readable evidence suitable for regression gates
75-
76-
### Flagship Repos
77-
78-
#### [cas-workstation](https://github.com/Coding-Autopilot-System/cas-workstation)
79-
80-
Windows-first AI-native developer workstation bootstrap.
3+
> **Speed without governance creates risk. Governance without speed creates irrelevance.**
4+
> Read the full thesis in **[our Vision](VISION.md)**.
815
82-
- Establishes a repeatable engineering baseline
83-
- Validates installed tools and configuration
84-
- Reduces setup drift before autonomous workflows run
6+
AI-native engineering portfolio: autonomous multi-agent execution, prompt governance, versioned
7+
lifecycle contracts, and Azure-ready platform foundations — every gate machine-executable and
8+
evidence-producing, not a meeting.
859

86-
#### [gsd-orchestrator](https://github.com/Coding-Autopilot-System/gsd-orchestrator)
87-
88-
C#/.NET 10 autonomous issue-to-PR engine.
89-
90-
- Reads GitHub issues
91-
- Plans and edits through a state machine
92-
- Uses MCP tooling for GitHub operations
93-
- Preserves checkpointed workflow state for retry and recovery
94-
95-
#### [Promptimprover](https://github.com/Coding-Autopilot-System/Promptimprover)
96-
97-
TypeScript MCP-first prompt governance layer.
98-
99-
- Refines prompts before execution
100-
- Injects repo-aware context and reusable rules
101-
- Builds traceability between prompt intent and engineering output
102-
103-
#### [autogen](https://github.com/Coding-Autopilot-System/autogen)
104-
105-
Python local-first multi-agent engineering workbench.
106-
107-
- Coordinates manager-led agent workflows
108-
- Supports provider routing and fallback
109-
- Keeps operator approvals and run artifacts visible
110-
111-
#### [cloud-security-service-model](https://github.com/Coding-Autopilot-System/cloud-security-service-model)
112-
113-
Enterprise cloud security operating model for Azure and hybrid environments.
114-
115-
- Service architecture and governance
116-
- Controls-as-code posture
117-
- Auditability, metrics, and runbooks
118-
119-
### Supporting Repos
120-
121-
#### [autopilot-core](https://github.com/Coding-Autopilot-System/autopilot-core)
122-
123-
Control plane for org-level CI repair automation.
124-
125-
#### [ci-autopilot](https://github.com/Coding-Autopilot-System/ci-autopilot)
126-
127-
Worker/runtime pattern for queued repair execution on self-hosted runners.
128-
129-
#### [autopilot-demo](https://github.com/Coding-Autopilot-System/autopilot-demo)
130-
131-
Bounded demo target for the full failure-to-fix loop.
132-
133-
## What This Portfolio Demonstrates
10+
> [!TIP]
11+
> Are you an enterprise engineering leader? Read **[Why Enterprises Need CAS](ENTERPRISE.md)**.
12+
13+
## Governed autonomy, in one diagram
14+
15+
```mermaid
16+
flowchart LR
17+
subgraph Control["Control plane - gsd-orchestrator"]
18+
G[Goal admission<br/>typed, bounded, budgeted] --> S[Dependency-aware<br/>scheduling]
19+
end
20+
subgraph Execution["Execution plane - autogen"]
21+
S --> W1[Worker fan-out<br/>isolated mutation scope]
22+
W1 --> T[Typed failure states<br/>structured telemetry]
23+
end
24+
subgraph Governance["Governance plane"]
25+
P[Promptimprover] -.gates.-> W1
26+
C[cas-contracts] -.validates.-> T
27+
E[cas-evals] --> V{Evidence<br/>gate}
28+
end
29+
T --> E
30+
V -->|proven| M[Merge via PR]
31+
V -->|failed| R[Bounded repair<br/>or halt]
32+
R --> S
33+
```
34+
35+
Full narrative, proof points, and every gate's falsifiable check: **[profile/VISION.md](VISION.md)**.
36+
37+
## Repo map
38+
39+
| Repo | Plane / category | What it does |
40+
|---|---|---|
41+
| [gsd-orchestrator](https://github.com/Coding-Autopilot-System/gsd-orchestrator) | Control | Autonomous issue-to-PR engine (.NET 10); goal admission and scheduling |
42+
| [autogen](https://github.com/Coding-Autopilot-System/autogen) | Execution | Multi-agent worker fan-out on Microsoft Agent Framework (Python) |
43+
| [Promptimprover](https://github.com/Coding-Autopilot-System/Promptimprover) | Governance | MCP-first prompt governance and traceability |
44+
| [cas-contracts](https://github.com/Coding-Autopilot-System/cas-contracts) | Governance | Versioned lifecycle schemas — prompts, events, artifacts, `FailureState` |
45+
| [cas-evals](https://github.com/Coding-Autopilot-System/cas-evals) | Governance | Deterministic evaluation and evidence-gate verification |
46+
| [cas-reference-product](https://github.com/Coding-Autopilot-System/cas-reference-product) | Proof | End-to-end reference workload with a [verified case study](https://github.com/Coding-Autopilot-System/cas-reference-product/blob/main/docs/case-study-evidence.md) |
47+
| [cas-platform](https://github.com/Coding-Autopilot-System/cas-platform) | Platform | Azure hosting/observability foundation — bicep-ready, deploy-locked |
48+
| [cloud-security-service-model](https://github.com/Coding-Autopilot-System/cloud-security-service-model) | Platform | Enterprise cloud security operating model |
49+
| [cas-workstation](https://github.com/Coding-Autopilot-System/cas-workstation) | Workstation | Windows-first AI-native developer workstation bootstrap |
50+
| [autopilot-core](https://github.com/Coding-Autopilot-System/autopilot-core) | CI Automation | Control plane for org-level CI repair automation |
51+
| [ci-autopilot](https://github.com/Coding-Autopilot-System/ci-autopilot) | CI Automation | Worker/runtime for queued repair execution on self-hosted runners |
52+
| [autopilot-demo](https://github.com/Coding-Autopilot-System/autopilot-demo) | CI Automation | Bounded demo target for the full failure-to-fix loop |
53+
| [.github (this repo)](https://github.com/Coding-Autopilot-System/.github) | Org | Governance, community health files, and this profile |
54+
55+
## Review path
56+
57+
Evaluating this portfolio quickly? Read in this order:
58+
59+
1. **[Vision](VISION.md)** — the governance-with-speed thesis and proof points.
60+
2. **[Verified case study](https://github.com/Coding-Autopilot-System/cas-reference-product/blob/main/docs/case-study-evidence.md)** — real evidence, not a demo script.
61+
3. **[cas-workstation](https://github.com/Coding-Autopilot-System/cas-workstation)** — the reproducible developer baseline.
62+
4. **[cas-contracts](https://github.com/Coding-Autopilot-System/cas-contracts)** — shared lifecycle and traceability model.
63+
5. **[gsd-orchestrator](https://github.com/Coding-Autopilot-System/gsd-orchestrator)** — autonomous execution design.
64+
65+
## What this portfolio demonstrates
13466

13567
- C#/.NET, TypeScript, Python, PowerShell, and Bicep across one coherent platform story
13668
- Versioned cross-repository contracts and reproducible evaluation evidence
@@ -139,25 +71,12 @@ Bounded demo target for the full failure-to-fix loop.
13971
- Enterprise-oriented concerns: auditability, resilience, boundaries, rollout, and documentation
14072
- Azure managed identity, infrastructure-as-code, observability, and hybrid architecture
14173

142-
## Review Path
143-
144-
If you are evaluating this portfolio quickly:
74+
## Organization standards
14575

146-
1. Read the [verified case study](https://github.com/Coding-Autopilot-System/cas-reference-product/blob/main/docs/case-study-evidence.md) and inspect its [immutable evidence bundle](https://github.com/Coding-Autopilot-System/cas-reference-product/tree/main/evidence/verified-local-golden-path-v0.1).
147-
2. Read [cas-workstation](https://github.com/Coding-Autopilot-System/cas-workstation) for the reproducible developer baseline.
148-
3. Read [cas-contracts](https://github.com/Coding-Autopilot-System/cas-contracts) for the shared lifecycle and traceability model.
149-
4. Read [cas-platform](https://github.com/Coding-Autopilot-System/cas-platform) for secure Azure hosting and observability.
150-
5. Read [cas-evals](https://github.com/Coding-Autopilot-System/cas-evals) for measurable quality and safety evidence.
151-
6. Read [gsd-orchestrator](https://github.com/Coding-Autopilot-System/gsd-orchestrator) for autonomous execution design.
152-
7. Read [Promptimprover](https://github.com/Coding-Autopilot-System/Promptimprover) for prompt governance and MCP thinking.
153-
8. Read [autogen](https://github.com/Coding-Autopilot-System/autogen) for operator-facing multi-agent runtime design.
154-
9. Read [cloud-security-service-model](https://github.com/Coding-Autopilot-System/cloud-security-service-model) for enterprise architecture depth.
155-
156-
## Organization Standards
157-
158-
Shared contribution, security, support, governance, intake, dependency, and release
159-
policies are maintained in the
160-
[organization `.github` repository](https://github.com/Coding-Autopilot-System/.github).
76+
Shared contribution, security, support, governance, intake, dependency, and release policies are
77+
maintained in this [organization `.github` repository](https://github.com/Coding-Autopilot-System/.github).
16178
Repository-specific standards may be stricter.
16279

16380
Built by [@OgeonX-Ai](https://github.com/OgeonX-Ai).
81+
82+
<!-- docs-verified: 46b4bcf4e334ce9aec4e00dcf7c9fb1c40db837a 2026-07-08 -->

0 commit comments

Comments
 (0)