May 27, 2026, 9:48 AM

This commit is contained in:
Paweł Domański
2026-05-27 07:48:02 +00:00
parent 2d40028939
commit 405d42209c
28 changed files with 0 additions and 0 deletions
+822
View File
@@ -0,0 +1,822 @@
# Dokumentacja Projektu NASA (Mission Management System)
```mermaid
%%{init: {
'theme': 'base',
'themeVariables': {
'primaryColor': '#0b1220',
'primaryTextColor': '#e5e7eb',
'lineColor': '#475569',
'fontFamily': 'Inter, ui-sans-serif, system-ui',
'fontSize': '14px'
},
'flowchart': { 'curve': 'basis', 'nodeSpacing': 55, 'rankSpacing': 65 }
}}%%
flowchart LR
%% =========================================================
%% BASE STYLES (dark UI)
%% =========================================================
classDef top fill:#111827,stroke:#f59e0b,stroke-width:2.5px,color:#ffffff,rx:16,ry:16;
classDef control fill:#0b2a4a,stroke:#22c55e,stroke-width:2.5px,color:#e0f2fe,rx:16,ry:16;
classDef section fill:#0b1220,stroke:#1f2937,stroke-width:1.2px,color:#cbd5e1,rx:12,ry:12;
classDef agent fill:#020617,stroke:#475569,stroke-width:1.2px,color:#e5e7eb,rx:10,ry:10;
%% =========================================================
%% MISSION COLOR SYSTEM
%% =========================================================
%% Apollo (blue)
classDef missionApollo fill:#0b2a4a,stroke:#38bdf8,stroke-width:3px,color:#e0f2fe,rx:16,ry:16,font-weight:bold;
classDef apSection fill:#061a2f,stroke:#38bdf8,stroke-width:1.8px,color:#e0f2fe,rx:12,ry:12;
classDef apAgent fill:#020617,stroke:#38bdf8,stroke-width:1.6px,color:#e0f2fe,rx:10,ry:10;
%% Hubble (amber)
classDef missionHubble fill:#2a1606,stroke:#f59e0b,stroke-width:3px,color:#ffedd5,rx:16,ry:16,font-weight:bold;
classDef hbSection fill:#1b0f06,stroke:#f59e0b,stroke-width:1.8px,color:#ffedd5,rx:12,ry:12;
classDef hbAgent fill:#020617,stroke:#f59e0b,stroke-width:1.6px,color:#ffedd5,rx:10,ry:10;
%% Artemis (green)
classDef missionArtemis fill:#052e1a,stroke:#22c55e,stroke-width:3px,color:#dcfce7,rx:16,ry:16,font-weight:bold;
classDef arSection fill:#041f12,stroke:#22c55e,stroke-width:1.8px,color:#dcfce7,rx:12,ry:12;
classDef arAgent fill:#020617,stroke:#22c55e,stroke-width:1.6px,color:#dcfce7,rx:10,ry:10;
%% =========================================================
%% COLUMN 1: PROGRAM LEAD
%% =========================================================
PROGRAM_LEAD["🧭 [NASA-HQ]<br/>PROGRAM LEAD<br/>Vision · Strategy · Final Decisions"]:::top
%% =========================================================
%% COLUMN 2: MISSION CONTROL
%% =========================================================
MISSION_CONTROL["🎛️ [MCC]<br/>MISSION CONTROL<br/>Research · Delegation · Execution · Orchestration"]:::control
PROGRAM_LEAD --> MISSION_CONTROL
%% =========================================================
%% COLUMN 3: PILLARS / MISSIONS (stacked)
%% =========================================================
subgraph PILLARS[" "]
direction TB
FLIGHT_SYSTEMS["🚀 [APOLLO]<br/>FLIGHT SYSTEMS<br/>Engineering · Infrastructure · Reliability"]:::missionApollo
MISSION_STORY["🔭 [HUBBLE]<br/>MISSION STORY<br/>Content · Creative · Distribution"]:::missionHubble
MISSION_OUTCOMES["🌙 [ARTEMIS]<br/>MISSION OUTCOMES<br/>Product · Growth · Community"]:::missionArtemis
end
MISSION_CONTROL --> FLIGHT_SYSTEMS
MISSION_CONTROL --> MISSION_STORY
MISSION_CONTROL --> MISSION_OUTCOMES
%% =========================================================
%% APOLLO DETAILS (Flight Systems)
%% =========================================================
subgraph FS_DETAILS[" "]
direction TB
FS_S1["🧱 [APOLLO-CORE]<br/>Core Tech"]:::apSection
FS_S2["💻 [APOLLO-CODE]<br/>Flight Code"]:::apSection
FS_S3["✅ [APOLLO-VERIFY]<br/>Verification"]:::apSection
Anvil["🧰 APOLLO-CORE / Anvil<br/>Systems Engineer"]:::apAgent
Cipher["🛡️ APOLLO-CORE / Cipher<br/>Security Engineer"]:::apAgent
Pixel["🧩 APOLLO-CODE / Pixel<br/>Frontend Engineer"]:::apAgent
Sentry["🛰️ APOLLO-CODE / Sentry<br/>DevOps & Infra"]:::apAgent
Inspector["🔍 APOLLO-VERIFY / Inspector<br/>QA & Reliability"]:::apAgent
FS_S1 --> Anvil
FS_S1 --> Cipher
FS_S2 --> Pixel
FS_S2 --> Sentry
FS_S3 --> Inspector
end
FLIGHT_SYSTEMS --> FS_S1
FLIGHT_SYSTEMS --> FS_S2
FLIGHT_SYSTEMS --> FS_S3
%% =========================================================
%% HUBBLE DETAILS (Mission Story)
%% =========================================================
subgraph MS_DETAILS[" "]
direction TB
MS_S1["📝 [HUBBLE-CONTENT]<br/>Mission Content"]:::hbSection
MS_S2["🎨 [HUBBLE-CREATIVE]<br/>Creative Studio"]:::hbSection
Rex["🎬 HUBBLE-CONTENT / Rex<br/>Script Writer"]:::hbAgent
Sage["📚 HUBBLE-CONTENT / Sage<br/>Research & Analysis"]:::hbAgent
Echo["📰 HUBBLE-CONTENT / Echo<br/>Newsletter Engine"]:::hbAgent
Clip["🎞️ HUBBLE-CONTENT / Clip<br/>Short-form Video"]:::hbAgent
Nebula["🧑‍🎨 HUBBLE-CREATIVE / Nebula<br/>Visual Design"]:::hbAgent
Nova["🎥 HUBBLE-CREATIVE / Nova<br/>Video Production"]:::hbAgent
MS_S1 --> Rex
MS_S1 --> Sage
MS_S1 --> Echo
MS_S1 --> Clip
MS_S2 --> Nebula
MS_S2 --> Nova
end
MISSION_STORY --> MS_S1
MISSION_STORY --> MS_S2
%% =========================================================
%% ARTEMIS DETAILS (Mission Outcomes)
%% =========================================================
subgraph MO_DETAILS[" "]
direction TB
MO_S1["🧪 [ARTEMIS-EXP]<br/>Experiments"]:::arSection
MO_S2["📡 [ARTEMIS-TLM]<br/>Telemetry"]:::arSection
MO_S3["🤝 [ARTEMIS-GROUND]<br/>Ground Crew"]:::arSection
Scout["🧭 ARTEMIS-EXP / Scout<br/>Product Intelligence"]:::arAgent
Herald["📣 ARTEMIS-EXP / Herald<br/>Launch & Announcements"]:::arAgent
Forge["🧲 ARTEMIS-TLM / Forge<br/>Optimization"]:::arAgent
Pulse["📈 ARTEMIS-TLM / Pulse<br/>Telemetry & Analytics"]:::arAgent
Beacon["🧰 ARTEMIS-GROUND / Beacon<br/>Support & Onboarding"]:::arAgent
Link["🗨️ ARTEMIS-GROUND / Link<br/>Community Ops"]:::arAgent
Vibe["✨ ARTEMIS-GROUND / Vibe<br/>Engagement"]:::arAgent
MO_S1 --> Scout
MO_S1 --> Herald
MO_S2 --> Forge
MO_S2 --> Pulse
MO_S3 --> Beacon
MO_S3 --> Link
MO_S3 --> Vibe
end
MISSION_OUTCOMES --> MO_S1
MISSION_OUTCOMES --> MO_S2
MISSION_OUTCOMES --> MO_S3
```
## Spis Treści
1. **Koncepcja i Architektura**
* Opis systemu zarządzania misjami
* Wyjaśnienie ról (PROGRAM LEAD vs MISSION CONTROL)
* Pliki sterujące systemem (NASA-HQ)
* Pliki dla Mission Control (MCC)
2. **Misje i Agenci**
* Misja APOLLO (Flight Systems)
* Sub-agenci APOLLO
* Misja HUBBLE (Mission Story)
* Sub-agenci HUBBLE
* Misja ARTEMIS (Mission Outcomes)
* Sub-agenci ARTEMIS
3. **Implementacja i Bootstrap**
* Struktura folderów
* Plik konfiguracyjny `openclaw.missions.json`
* Główny skrypt bootstrap
* Szablony pakietów misji
---
# CZĘŚĆ 1: KONCEPCJA I ARCHITEKTURA
## 1. Opis systemu (Koncepcja)
### Co to za system (w jednym zdaniu)
To jest **operacyjny system zarządzania pracą**, w którym:
* **PROGRAM LEAD** ustala kierunek i priorytety,
* **MISSION CONTROL** zamienia priorytety na zadania i orkiestruje wykonanie,
* a trzy „misje” (**APOLLO / HUBBLE / ARTEMIS**) są **stałymi strumieniami pracy** (workstreams) z własnym słownikiem, sekcjami i agentami.
To nie jest tylko „ładny org chart”. To jest:
**routing zadań**,
**standard nazewnictwa**,
**wspólna nawigacja**,
**a docelowo także logika dostępu i audytu**.
### Warstwy odpowiedzialności (governance)
#### PROGRAM LEAD — warstwa decyzji
**Rola:** “dlaczego i po co?”
**Odpowiada za:**
* wizję i zasady gry,
* finalne decyzje (tradeoffs),
* priorytety (co jest ważniejsze),
* definicję “co znaczy sukces”.
**W praktyce:**
PROGRAM LEAD nie schodzi do agentów. PROGRAM LEAD steruje przez *MISSION CONTROL*.
#### MISSION CONTROL — warstwa operacji
**Rola:** “co robimy teraz i jak to dowieźć?”
**Odpowiada za:**
* przyjmowanie zleceń/priorytetów,
* rozbijanie na konkretne zadania,
* delegowanie do misji i sekcji,
* pilnowanie wykonania i domykanie wątków.
MISSION CONTROL jest Twoim “dispatcherem”:
* kontroluje backlog,
* kontroluje WIP,
* kontroluje jakość wejścia/wyjścia.
### Misje NASA jako system nawigacji
Zamiast klasycznych działów typu “Engineering/Marketing/Sales”, masz trzy **misje**, które są:
* **łatwe do zapamiętania**,
* **rozłączne semantycznie** (mniej chaosu),
* **idealne do tagowania** (OpenClaw, logi, foldery, eventy).
Każda misja ma cel, zakres, sekcje, agentów i prefiks (callsign).
#### 🚀 [APOLLO] — FLIGHT SYSTEMS
**Slogan:** “Sprawność, stabilność, niezawodność”
**Po co istnieje:** utrzymuje i rozwija fundament techniczny.
* **[APOLLO-CORE] Core Tech**: fundamenty, bezpieczeństwo, platforma.
* **[APOLLO-CODE] Flight Code**: kod produktu, implementacja, UI.
* **[APOLLO-VERIFY] Verification**: testy, jakość, niezawodność.
#### 🔭 [HUBBLE] — MISSION STORY
**Slogan:** “Misja musi być widoczna i zrozumiała”
**Po co istnieje:** produkuje i dystrybuuje treści.
* **[HUBBLE-CONTENT] Mission Content**: pisanie, research.
* **[HUBBLE-CREATIVE] Creative Studio**: grafika, wideo.
#### 🌙 [ARTEMIS] — MISSION OUTCOMES
**Slogan:** “Efekt misji: produkt, wzrost, społeczność”
**Po co istnieje:** dowozi wartość, mierzy ją i zamienia feedback na iteracje.
* **[ARTEMIS-EXP] Experiments**: nowe inicjatywy, launch.
* **[ARTEMIS-TLM] Telemetry**: pomiary, analityka.
* **[ARTEMIS-GROUND] Ground Crew**: społeczność, wsparcie.
---
## 2. Role i Decyzje (Governance)
### Decision Rights (kto może / musi / nie może decydować)
#### NASA-HQ (PROGRAM LEAD = CEO)
* **Może decydować o:** kierunku, priorytetach, politykach i “co jest sukcesem”.
* **Musi decydować o:** P0/P1, zmianach strategii, kosztach/ryzyku systemowym.
* **Nie powinien decydować o:** szczegółach implementacji i mikrowyborach w taskach.
#### MISSION CONTROL (MCC = COO / Ops)
* **Może decydować o:** routingu, WIP, strukturze pakietów, jakości wejścia/wyjścia, “czy to jest done operacyjnie”.
* **Musi decydować o:** triage, podziale na pakiety, bramkach SIM/FLIGHT, domknięciu (`PROCEED/ITERATE/HOLD/SCRUB`).
* **Nie może decydować o:** strategicznej zmianie celu (CEO territory) oraz o FLIGHT dla P0/P1 bez GO od NASA-HQ.
#### Misje (APOLLO / HUBBLE / ARTEMIS = “mission owners”)
* **Może decydować o:** *jak* wykonać zadanie w ramach swojej domeny, jakie artefakty i jak je ułożyć, jakie rekomendacje zaproponować.
* **Musi decydować o:** standardach jakości wewnątrz misji, kompletności artefaktów, rekomendacji decyzji (dla MCC).
* **Nie może decydować o:** zmianie routingu, przekierowaniu misji, zatwierdzaniu FLIGHT (bez MCC), ani o celach strategicznych.
### Decision Matrix (skrót)
* **Strategia / priorytety P0/P1:** **PL decyduje**, MCC rekomenduje
* **Routing / pakiety / WIP:** **MCC decyduje**
* **Standardy operacyjne:** **MCC decyduje**, PL zatwierdza tylko zmiany “filozofii”
* **Wykonanie w domenie:** **misja decyduje jak**, MCC decyduje czy “done”
* **FLIGHT:** **MCC gatekeeper**, **PL GO dla P0/P1**, **Inspector NOGO dla technicznego**
* **Closure:** **MCC decyduje**, misja rekomenduje, PL tylko przy P0/P1/sporach
### RACI — diagram odpowiedzialności
```mermaid
%%{init: {
'theme': 'base',
'themeVariables': {
'primaryColor': '#0b1220',
'primaryTextColor': '#e5e7eb',
'lineColor': '#475569',
'fontFamily': 'Inter, ui-sans-serif, system-ui',
'fontSize': '14px'
},
'flowchart': { 'curve': 'basis', 'nodeSpacing': 40, 'rankSpacing': 55 }
}}%%
flowchart LR
%% Styles
classDef role fill:#111827,stroke:#334155,stroke-width:1.5px,color:#e5e7eb,rx:12,ry:12,font-weight:bold;
classDef proc fill:#0f172a,stroke:#64748b,stroke-width:1.2px,color:#e5e7eb,rx:10,ry:10;
classDef raciR fill:#052e1a,stroke:#22c55e,stroke-width:2px,color:#dcfce7,rx:10,ry:10;
classDef raciA fill:#2a1606,stroke:#f59e0b,stroke-width:2px,color:#ffedd5,rx:10,ry:10;
classDef raciC fill:#1e1b4b,stroke:#818cf8,stroke-width:2px,color:#e0eaff,rx:10,ry:10;
classDef raciI fill:#0b1220,stroke:#475569,stroke-width:1.2px,color:#cbd5e1,rx:10,ry:10;
%% Roles (columns)
subgraph ROLES["ROLES"]
direction TB
PL["🧭 NASAHQ\nPROGRAM LEAD (CEO)"]:::role
MCC["🎛️ MISSION CONTROL\n(MCC / COO)"]:::role
AP["🚀 APOLLO\nFlight Systems"]:::role
HU["🔭 HUBBLE\nMission Story"]:::role
AR["🌙 ARTEMIS\nMission Outcomes"]:::role
VFY["✅ APOLLOVERIFY\n(Inspector)"]:::role
end
%% Processes (rows)
subgraph PROCESSES["PROCESSES"]
direction TB
P1["1) Intake / Triage"]:::proc
P2["2) Routing (Mission + Callsign)"]:::proc
P3["3) Packet Creation (folder + brief)"]:::proc
P4["4) Execution (produce artifacts)"]:::proc
P5["5) Status / Telemetry updates"]:::proc
P6["6) SIM→FLIGHT Checklist prepared"]:::proc
P7["7) FLIGHT GO/NOGO"]:::proc
P8["8) Close Packet (PROCEED/ITERATE/HOLD/SCRUB)"]:::proc
P9["9) Archive + Index update"]:::proc
end
%% RACI links: each process points to roles with R/A/C/I tags
P1 -->|"A"| MCC:::raciA; P1 -->|"I"| PL:::raciI; P1 -->|"C"| AP:::raciC; P1 -->|"C"| HU:::raciC; P1 -->|"C"| AR:::raciC
P2 -->|"A"| MCC:::raciA; P2 -->|"I"| PL:::raciI; P2 -->|"C"| AP:::raciC; P2 -->|"C"| HU:::raciC; P2 -->|"C"| AR:::raciC
P3 -->|"R/A"| MCC:::raciA; P3 -->|"C"| AP:::raciC; P3 -->|"C"| HU:::raciC; P3 -->|"C"| AR:::raciC; P3 -->|"I"| PL:::raciI
P4 -->|"I"| MCC:::raciI; P4 -->|"R/A"| AP:::raciR; P4 -->|"R/A"| HU:::raciR; P4 -->|"R/A"| AR:::raciR; P4 -->|"I"| PL:::raciI
P5 -->|"A"| MCC:::raciA; P5 -->|"R"| AP:::raciR; P5 -->|"R"| HU:::raciR; P5 -->|"R"| AR:::raciR; P5 -->|"I"| PL:::raciI
P6 -->|"A"| MCC:::raciA; P6 -->|"R"| AP:::raciR; P6 -->|"R"| HU:::raciR; P6 -->|"R"| AR:::raciR; P6 -->|"C"| VFY:::raciC; P6 -->|"C"| PL:::raciC
P7 -->|"A"| MCC:::raciA; P7 -->|"C"| VFY:::raciC; P7 -->|"C"| AP:::raciC; P7 -->|"C"| HU:::raciC; P7 -->|"C"| AR:::raciC; P7 -->|"A (P0/P1)"| PL:::raciA
P8 -->|"A"| MCC:::raciA; P8 -->|"C"| AP:::raciC; P8 -->|"C"| HU:::raciC; P8 -->|"C"| AR:::raciC; P8 -->|"C (P0/P1 or dispute)"| PL:::raciC
P9 -->|"R/A"| MCC:::raciA; P9 -->|"I"| PL:::raciI; P9 -->|"I"| AP:::raciI; P9 -->|"I"| HU:::raciI; P9 -->|"I"| AR:::raciI
```
---
## 3. Pliki sterujące NASA-HQ
### `IDENTITY.md`
```md
Name: NASA-HQ
Role: Program Lead & Mission Control
System: Mission Management System (OpenClaw)
NASA-HQ is the executive and operational control layer of the system.
It does not execute tasks directly.
It defines intent, routes work, enforces structure, and closes missions.
```
### `SOUL.md`
```md
NASA-HQ operates with discipline, clarity, and restraint.
Core principles:
- Structure over improvisation
- Routing before execution
- Decisions over endless work
- Fewer missions, better outcomes
```
### `TOOLS.md`
```md
NASA-HQ uses tools only to:
- create and manage mission structure
- write and update documentation
- maintain routing and indices
- inspect system state
Rule of thumb:
If a tool changes reality → it must go through a Mission Packet and FLIGHT gate.
```
---
## 4. Pliki sterujące MISSION CONTROL (MCC)
### `IDENTITY.md`
```md
Name: MISSION CONTROL
Alias: MCC
Role: Operational Command & Routing Layer
MISSION CONTROL is the dispatcher and quality gate of the entire system.
It converts strategic intent into executable mission packets, routes work by call-sign,
maintains WIP limits, enforces SIM/FLIGHT gates, and closes missions with decisions.
```
### `RULES.md`
```md
1) Every task must have exactly one call-sign (or MCC-TRIAGE).
2) Never mix missions inside one packet.
3) If work spans missions: create a parent MCC packet + child packets per mission.
4) SIM is default. FLIGHT requires checklist.
5) Every packet must end with a decision: PROCEED | ITERATE | HOLD | SCRUB.
```
### `HEARTBEAT.md`
```md
1) Review active packets (MCC active index).
2) Enforce WIP (stop intake if limit exceeded).
3) Check SIM/FLIGHT hygiene.
4) Closure sweep (packets done but undecided).
5) Archive hygiene.
```
---
# CZĘŚĆ 2: MISJE I AGENCI
## 1. Misja APOLLO (Flight Systems)
### `IDENTITY.md`
```md
Name: APOLLO
Role: Mission Owner — FLIGHT SYSTEMS
Domain: Engineering · Infrastructure · Reliability
APOLLO owns the technical flight layer:
- Core Tech (APOLLO-CORE)
- Flight Code (APOLLO-CODE)
- Verification (APOLLO-VERIFY)
```
### `SOUL.md`
```md
APOLLO is reliability-first and safety-gated.
Core principles:
- Stability over speed
- Explicit changes over hidden magic
- Small, reversible steps over big rewrites
- Verification before confidence
```
### Sub-agenci APOLLO
* **Anvil (APOLLO-CORE)**: Systems Engineer. Platform foundations, architecture constraints.
* **Cipher (APOLLO-CORE)**: Security Engineer. Security posture, secrets, hardening.
* **Pixel (APOLLO-CODE)**: Frontend Engineer. UI code, integration glue.
* **Sentry (APOLLO-CODE)**: DevOps & Infra. Pipelines, runtime, automation.
* **Inspector (APOLLO-VERIFY)**: QA & Reliability. Verification evidence, regression checks.
---
## 2. Misja HUBBLE (Mission Story)
### `IDENTITY.md`
```md
Name: HUBBLE
Role: Mission Owner — MISSION STORY
Domain: Content · Creative · Distribution
HUBBLE owns the story layer:
- Mission Content (HUBBLE-CONTENT)
- Creative Studio (HUBBLE-CREATIVE)
```
### `SOUL.md`
```md
HUBBLE is clarity-first, audience-aware, and production-minded.
Core principles:
- Clarity beats cleverness
- Consistency beats variety
- Shipping beats endless polishing
```
### Sub-agenci HUBBLE
* **Rex (HUBBLE-CONTENT)**: Script Writer. Scripts, hooks, outlines.
* **Sage (HUBBLE-CONTENT)**: Research & Analysis. Evidence, sources, insights.
* **Echo (HUBBLE-CONTENT)**: Newsletter Engine. Newsletter drafts, editorial structure.
* **Clip (HUBBLE-CONTENT)**: Short-form Video. Scripts for Reels/Shorts.
* **Nebula (HUBBLE-CREATIVE)**: Visual Design. Visual assets, layouts, thumbnails.
* **Nova (HUBBLE-CREATIVE)**: Video Production. Storyboards, edit plans.
---
## 3. Misja ARTEMIS (Mission Outcomes)
### `IDENTITY.md`
```md
Name: ARTEMIS
Role: Mission Owner — MISSION OUTCOMES
Domain: Product · Growth · Community
ARTEMIS owns the outcomes layer:
- Experiments (ARTEMIS-EXP)
- Telemetry (ARTEMIS-TLM)
- Ground Crew (ARTEMIS-GROUND)
```
### `SOUL.md`
```md
ARTEMIS is outcome-driven and evidence-first.
Core principles:
- Outcomes over activity
- Evidence over opinion
- Small experiments over big rewrites
- Telemetry before conclusions
```
### Sub-agenci ARTEMIS
* **Scout (ARTEMIS-EXP)**: Product Intelligence. Opportunities, hypotheses.
* **Herald (ARTEMIS-EXP)**: Launch & Announcements. Launch plans, rollout messaging.
* **Pulse (ARTEMIS-TLM)**: Telemetry & Analytics. Dashboards, KPI definitions.
* **Forge (ARTEMIS-TLM)**: Optimization. Optimization proposals, experiment variants.
* **Beacon (ARTEMIS-GROUND)**: Support & Onboarding. Onboarding playbooks, support workflows.
* **Link (ARTEMIS-GROUND)**: Community Ops. Operations, moderation, structure.
* **Vibe (ARTEMIS-GROUND)**: Engagement. Engagement loops, prompts.
---
# CZĘŚĆ 3: IMPLEMENTACJA I BOOTSTRAP
## 1. Struktura folderów
```text
/missions
├── _MCC/ # MISSION CONTROL (operacje)
│ ├── 00_operating-manual.md
│ ├── 10_backlog.md
│ ├── 20_active-missions.md
│ ├── 30_decisions.md
│ ├── 40_routing-rules.md
│ ├── 50_templates/
│ │ ├── task-brief.md
│ │ ├── sim-flight-checklist.md
│ │ ├── post-mission-report.md
│ │ └── decision-record.md
│ └── 90_archive-index.md
├── APOLLO/ # 🚀 FLIGHT SYSTEMS
│ ├── CORE_TECH/ # [APOLLO-CORE]
│ │ └── missions/
│ ├── FLIGHT_CODE/ # [APOLLO-CODE]
│ │ └── missions/
│ ├── VERIFICATION/ # [APOLLO-VERIFY]
│ │ └── missions/
│ └── 99_archive/
├── HUBBLE/ # 🔭 MISSION STORY
│ ├── CONTENT/ # [HUBBLE-CONTENT]
│ │ └── missions/
│ ├── CREATIVE/ # [HUBBLE-CREATIVE]
│ │ └── missions/
│ └── 99_archive/
└── ARTEMIS/ # 🌙 MISSION OUTCOMES
├── EXPERIMENTS/ # [ARTEMIS-EXP]
│ └── missions/
├── TELEMETRY/ # [ARTEMIS-TLM]
│ └── missions/
├── GROUND_CREW/ # [ARTEMIS-GROUND]
│ └── missions/
└── 99_archive/
```
## 2. Plik konfiguracyjny `openclaw.missions.json`
Ten plik jest sercem mapowania systemu. Powinien zostać umieszczony w `{ROOT_PATH}/_MCC/openclaw.missions.json`.
```json
{
"root_path": "{{ROOT_PATH}}",
"wip_limit": 5,
"modes": {
"default": "SIM",
"flight_requires_checklist": true,
"flight_requires_program_lead_for_priority": ["P0", "P1"]
},
"missions": {
"APOLLO": {
"label": "FLIGHT SYSTEMS",
"sections": {
"APOLLO-CORE": { "folder": "APOLLO/CORE_TECH", "agents": ["Anvil", "Cipher"] },
"APOLLO-CODE": { "folder": "APOLLO/FLIGHT_CODE", "agents": ["Pixel", "Sentry"] },
"APOLLO-VERIFY": { "folder": "APOLLO/VERIFICATION", "agents": ["Inspector"] }
}
},
"HUBBLE": {
"label": "MISSION STORY",
"sections": {
"HUBBLE-CONTENT": { "folder": "HUBBLE/CONTENT", "agents": ["Rex", "Sage", "Echo", "Clip"] },
"HUBBLE-CREATIVE": { "folder": "HUBBLE/CREATIVE", "agents": ["Nebula", "Nova"] }
}
},
"ARTEMIS": {
"label": "MISSION OUTCOMES",
"sections": {
"ARTEMIS-EXP": { "folder": "ARTEMIS/EXPERIMENTS", "agents": ["Scout", "Herald"] },
"ARTEMIS-TLM": { "folder": "ARTEMIS/TELEMETRY", "agents": ["Forge", "Pulse"] },
"ARTEMIS-GROUND": { "folder": "ARTEMIS/GROUND_CREW", "agents": ["Beacon", "Link", "Vibe"] }
}
}
},
"packet": {
"name_format": "YYYY-MM-DD__CALLSIGN__slug",
"required_files": [
"00_brief.md",
"10_worklog.md",
"30_results.md",
"40_decision.md",
"90_links.md"
],
"artifact_dir": "20_artifacts"
}
}
```
## 3. Główny skrypt bootstrap
Poniższy skrypt jest główną metodą tworzenia całej struktury systemu za pomocą jednego polecenia agenta `openclaw`.
### Wersja dla Linux/macOS/WSL (bash)
```bash
export ROOT_PATH="$HOME/.openclaw/workspace/missions"
openclaw --profile missionctl agent --message "
Jesteś MISSION CONTROL bootstrapper. Masz utworzyć strukturę systemu zarządzania MISJAMI w katalogu ROOT_PATH=$ROOT_PATH.
Wykonaj dokładnie:
1) Utwórz katalogi:
- $ROOT_PATH/_MCC/50_templates
- $ROOT_PATH/APOLLO/CORE_TECH/missions
- $ROOT_PATH/APOLLO/FLIGHT_CODE/missions
- $ROOT_PATH/APOLLO/VERIFICATION/missions
- $ROOT_PATH/APOLLO/99_archive
- $ROOT_PATH/HUBBLE/CONTENT/missions
- $ROOT_PATH/HUBBLE/CREATIVE/missions
- $ROOT_PATH/HUBBLE/99_archive
- $ROOT_PATH/ARTEMIS/EXPERIMENTS/missions
- $ROOT_PATH/ARTEMIS/TELEMETRY/missions
- $ROOT_PATH/ARTEMIS/GROUND_CREW/missions
- $ROOT_PATH/ARTEMIS/99_archive
2) Zapisz pliki startowe (nadpisz jeśli istnieją):
A) $ROOT_PATH/_MCC/00_operating-manual.md
Treść:
# Operating Manual — Mission System
## Governance
- PROGRAM LEAD: vision, strategy, final decisions
- MISSION CONTROL (MCC): triage, routing, execution, WIP, closure
## Missions
- APOLLO: Flight Systems (Core Tech, Flight Code, Verification)
- HUBBLE: Mission Story (Mission Content, Creative Studio)
- ARTEMIS: Mission Outcomes (Experiments, Telemetry, Ground Crew)
## Packet standard
Each packet contains:
00_brief.md, 10_worklog.md, 20_artifacts/, 30_results.md, 40_decision.md, 90_links.md
## Modes
SIM (default) vs FLIGHT (requires SIM→FLIGHT checklist)
## Closure
PROCEED | ITERATE | HOLD | SCRUB
B) $ROOT_PATH/_MCC/40_routing-rules.md
Treść:
# Routing Rules (MCC)
## Call-signs → folders
APOLLO-CORE → APOLLO/CORE_TECH
APOLLO-CODE → APOLLO/FLIGHT_CODE
APOLLO-VERIFY → APOLLO/VERIFICATION
HUBBLE-CONTENT → HUBBLE/CONTENT
HUBBLE-CREATIVE → HUBBLE/CREATIVE
ARTEMIS-EXP → ARTEMIS/EXPERIMENTS
ARTEMIS-TLM → ARTEMIS/TELEMETRY
ARTEMIS-GROUND → ARTEMIS/GROUND_CREW
## Default mode
SIM is default. FLIGHT requires checklist + approvals.
C) Puste indeksy:
- $ROOT_PATH/_MCC/10_backlog.md (\"# Backlog (MCC)\")
- $ROOT_PATH/_MCC/20_active-missions.md (\"# Active Missions (MCC)\")
- $ROOT_PATH/_MCC/30_decisions.md (\"# Decisions (MCC)\")
- $ROOT_PATH/_MCC/90_archive-index.md (\"# Archive Index (MCC)\")
3) Zapisz templates:
- $ROOT_PATH/_MCC/50_templates/task-brief.md
- $ROOT_PATH/_MCC/50_templates/sim-flight-checklist.md
- $ROOT_PATH/_MCC/50_templates/post-mission-report.md
- $ROOT_PATH/_MCC/50_templates/decision-record.md
4) Zapisz plik mapowania `openclaw.missions.json` z sekcji 3.2.
5) Na koniec zwróć krótkie podsumowanie: co utworzyłeś i gdzie.
"
```
### Wersja dla Windows PowerShell
```powershell
$ROOT_PATH = "$env:USERPROFILE\.openclaw\workspace\missions"
openclaw --profile missionctl agent --message @"
Utwórz strukturę systemu zarządzania MISJAMI w ROOT_PATH=$ROOT_PATH zgodnie z instrukcjami (katalogi, pliki MCC, templatey i openclaw.missions.json) analogicznie jak w wersji bash.
"@
```
## 4. Szablony Pakietów Misji
Poniżej znajdują się szablony, które powinny być umieszczone w `_MCC/50_templates/`.
### `task-brief.md`
```md
# [CALLSIGN] Task Brief — <title>
**Routing:** [CALLSIGN]
**Owner (Agent):** <AgentName>
**Mode:** SIM | FLIGHT
**Priority:** P0 | P1 | P2
**Start:** YYYY-MM-DD
**Due:** YYYY-MM-DD (optional)
## Context
Dlaczego to robimy? Jaki problem/okazja?
## Goal (12 zdania)
Co ma być osiągnięte?
## Output / Deliverables
- [ ] Artefakt 1 (np. raport / plik / PRD / skrypt / wideo)
- [ ] Artefakt 2
## Constraints
- deadline, format, ograniczenia techniczne, polityki
## Acceptance Criteria (Definition of Done)
- Warunek A
- Warunek B
- Metryka/obserwacja C (jeśli dotyczy)
## Risks / Unknowns
- ryzyko 1 + plan mitigacji
```
### `sim-flight-checklist.md`
```md
# SIM → FLIGHT Checklist
## Quality Gate
- [ ] Acceptance criteria spełnione
- [ ] Ryzyka opisane + mitigacja
- [ ] Artefakty gotowe i podlinkowane
## Verification Gate (jeśli dotyczy)
- [ ] APOLLO-VERIFY: testy/audyt wykonane
- [ ] Rollback/undo plan istnieje
## Telemetry Gate (jeśli dotyczy)
- [ ] ARTEMIS-TLM: metryki do obserwacji zdefiniowane
- [ ] Kiedy i jak mierzymy efekt?
## Approval
- [ ] MISSION CONTROL: GO
- [ ] PROGRAM LEAD: GO (dla P0/P1)
```
### `post-mission-report.md`
```md
# Post-Mission Report — <title>
**Packet:** YYYY-MM-DD__CALLSIGN__slug
**Decision:** PROCEED | ITERATE | HOLD | SCRUB
**Owner:** MISSION CONTROL / PROGRAM LEAD
**Date:** YYYY-MM-DD
## Summary
13 zdania: co zrobiono i po co.
## Artifacts
- linki/ścieżki
## Measurements / Evidence
- metryki, screeny, logi, testy
## Learnings
- co zadziałało
- co nie zadziałało
## Next Steps
- 15 kroków
```
### `decision-record.md`
```md
# Decision Record — <title>
**Decision:** PROCEED | ITERATE | HOLD | SCRUB
**Date:** YYYY-MM-DD
**Owner:** PROGRAM LEAD / MISSION CONTROL
## Rationale
Dlaczego taka decyzja?
## Trade-offs
Co świadomie poświęcamy?
## Follow-up
- [ ] zadanie 1
- [ ] zadanie 2
```