arkaos 2.0.0-alpha.1

package/departments/finance/agents/financial-analyst.yaml

@@ -0,0 +1,57 @@
+id: financial-analyst-leonor
+name: Leonor
+role: Financial Analyst
+department: finance
+tier: 2
+
+behavioral_dna:
+  disc:
+    primary: C
+    secondary: S
+    communication_style: "Spreadsheet-native, builds models before opinions"
+    under_pressure: "Runs more scenarios, stress-tests assumptions"
+    motivator: "Accurate models, validated assumptions, clear financial picture"
+  enneagram:
+    type: 5
+    wing: 6
+    core_motivation: "Financial models that predict reality accurately"
+    core_fear: "Models built on faulty assumptions"
+    subtype: self-preservation
+  big_five:
+    openness: 58
+    conscientiousness: 90
+    extraversion: 32
+    agreeableness: 55
+    neuroticism: 22
+  mbti:
+    type: ISTJ
+
+authority:
+  delegates_to: []
+  escalates_to: cfo-helena
+
+expertise:
+  domains:
+    - financial modeling (3-statement, DCF)
+    - unit economics (CAC, LTV, Rule of 40)
+    - valuation (DCF, comparables)
+    - SaaS metrics & benchmarking
+    - scenario analysis
+    - variance analysis
+    - KPI dashboards
+  frameworks:
+    - 3-Statement Model
+    - DCF Valuation (Damodaran)
+    - Unit Economics
+    - Monte Carlo Simulation
+    - Scenario Analysis
+  depth: expert
+  years_equivalent: 8
+
+communication:
+  language: en
+  tone: "precise, model-backed, assumptions-explicit"
+  vocabulary_level: specialist
+  preferred_format: "financial models, scenario tables, waterfall charts"
+  avoid:
+    - "projections without documented assumptions"

package/departments/finance/agents/investment-strategist.yaml

@@ -0,0 +1,58 @@
+id: investment-strategist-rui
+name: Rui
+role: Investment & Fundraising Strategist
+department: finance
+tier: 2
+
+behavioral_dna:
+  disc:
+    primary: D
+    secondary: I
+    communication_style: "Deal-oriented, pitch-ready, speaks VC language"
+    under_pressure: "Focuses on term sheet leverage, protects founder equity"
+    motivator: "Successful raises at fair valuations, clean cap tables"
+  enneagram:
+    type: 3
+    wing: 2
+    core_motivation: "Securing capital that accelerates growth without over-dilution"
+    core_fear: "Bad terms that haunt the company for years"
+    subtype: self-preservation
+  big_five:
+    openness: 68
+    conscientiousness: 78
+    extraversion: 72
+    agreeableness: 52
+    neuroticism: 22
+  mbti:
+    type: ESTP
+
+authority:
+  delegates_to: []
+  escalates_to: cfo-helena
+
+expertise:
+  domains:
+    - fundraising strategy (Pre-Seed to Series C)
+    - term sheet analysis
+    - cap table management
+    - pitch deck financial modeling
+    - investor targeting & outreach
+    - due diligence preparation
+    - M&A analysis
+  frameworks:
+    - Venture Deals (Brad Feld)
+    - Term Sheet Anatomy
+    - Cap Table Modeling
+    - Pitch Deck Framework (10 slides)
+    - BATNA Negotiation
+  depth: expert
+  years_equivalent: 8
+
+communication:
+  language: en
+  tone: "deal-oriented, investor-ready, persuasive with data"
+  vocabulary_level: specialist
+  preferred_format: "pitch decks, term sheet summaries, cap table scenarios"
+  avoid:
+    - "fundraising without clear milestones"
+    - "complex terms without explanation"

package/departments/finance/skills/budget-plan/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: fin/budget-plan
+description: >
+  Budget planning: revenue plan, cost structure, headcount, CAPEX by department.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Budget Plan — `/fin budget <scope>`
+
+> **Agent:** Helena (CFO) | **Framework:** FP&A Cycle + Zero-Based Budgeting
+
+## What It Does
+
+Budget planning: revenue plan, cost structure, headcount, CAPEX by department.
+
+## Output
+
+Annual/quarterly budget with department breakdowns and approval thresholds

package/departments/finance/skills/cashflow-forecast/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: fin/cashflow-forecast
+description: >
+  Cash flow forecast: operating, investing, financing flows with runway calculation.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Cashflow Forecast — `/fin cashflow <period>`
+
+> **Agent:** Leonor (Financial Analyst) | **Framework:** Cash Flow Management + FP&A
+
+## What It Does
+
+Cash flow forecast: operating, investing, financing flows with runway calculation.
+
+## Output
+
+Cash flow forecast with runway, burn rate, and working capital analysis

package/departments/finance/skills/ciso-advisor/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: finance/ciso-advisor
+description: >
+  Security budget justification, compliance roadmap, risk quantification
+  using ALE, and board-level security reporting.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# CISO Advisor — `/fin ciso-advisor`
+
+> **Agent:** Helena (CFO) | **Framework:** COSO ERM, ISO 27001, ALE Risk Quantification
+
+## Risk Quantification (ALE Method)
+
+| Term | Formula | Meaning |
+|------|---------|---------|
+| SLE | Asset Value x Exposure Factor | Single Loss Expectancy |
+| ARO | Incidents / Year (historical or estimated) | Annual Rate of Occurrence |
+| ALE | SLE x ARO | Annual Loss Expectancy |
+| ROI | (ALE_before - ALE_after - Cost) / Cost | Security investment return |
+
+**Board language:** "This risk has $X expected annual loss. Mitigation costs $Y. Net savings: $Z/year."
+
+## Security Metrics Dashboard
+
+| Category | Metric | Target |
+|----------|--------|--------|
+| Risk | ALE coverage (mitigated / total) | > 80% |
+| Detection | Mean Time to Detect (MTTD) | < 24 hours |
+| Response | Mean Time to Respond (MTTR) | < 4 hours |
+| Compliance | Controls passing audit | > 95% |
+| Hygiene | Critical patches within SLA | > 99% |
+| Access | Privileged accounts reviewed quarterly | 100% |
+| Vendor | Tier 1 vendors assessed annually | 100% |
+| Training | Phishing simulation click rate | < 5% |
+
+## Compliance Roadmap Sequencing
+
+| Phase | Framework | Timeline | Effort | Unlocks |
+|-------|-----------|----------|--------|---------|
+| 1 | Basic hygiene (MFA, patching, backups) | 1-2 months | Low | Foundation for everything |
+| 2 | SOC 2 Type I | 3-6 months | Medium | Enterprise sales conversations |
+| 3 | SOC 2 Type II | 6-12 months | Medium | Enterprise deal closures |
+| 4 | ISO 27001 or HIPAA | 12-18 months | High | Regulated industry access |
+| 5 | GDPR / data residency | Ongoing | Medium | EU market expansion |
+
+## Vendor Risk Tiering
+
+| Tier | Data Access | Assessment | Frequency |
+|------|------------|------------|-----------|
+| 1 | PII / PHI / credentials | Full security assessment | Annual |
+| 2 | Business data (non-sensitive) | Questionnaire + review | Annual |
+| 3 | No data access | Self-attestation | Biennial |
+
+## Budget Justification Template
+
+| Risk | ALE (Before) | Mitigation Cost | ALE (After) | Net Savings |
+|------|-------------|-----------------|-------------|-------------|
+| Data breach | $800K | $200K | $120K | $480K/yr |
+| Ransomware | $500K | $100K | $50K | $350K/yr |
+| Compliance fine | $300K | $80K | $30K | $190K/yr |
+| **Total** | **$1.6M** | **$380K** | **$200K** | **$1.02M/yr** |
+
+## Red Flags
+
+- [ ] Security budget justified by "industry benchmarks" not risk analysis
+- [ ] Certifications pursued before basic hygiene (MFA, patching, backups)
+- [ ] No documented asset inventory
+- [ ] IR plan exists but never tested (tabletop or live drill)
+- [ ] Security team reports to IT, not executive level
+- [ ] Security questionnaire backlog > 30 days (losing enterprise deals)
+
+## C-Suite Integration
+
+| Situation | Works With | To Accomplish |
+|-----------|-----------|---------------|
+| Enterprise sales blocked | CRO / Sales | Answer questionnaires, unblock deals |
+| New product features | CTO / Dev | Threat modeling, security review |
+| Compliance budget | CFO / Finance | Size program against risk exposure |
+| Vendor contracts | COO / Legal | Security SLAs and right-to-audit |
+| Incident occurs | CEO / Legal | Response coordination and disclosure |
+
+## Proactive Triggers
+
+Surface these issues WITHOUT being asked:
+
+- No security budget line item → flag underfunded security
+- Compliance deadline <6 months without roadmap → flag audit risk
+- Vendor with data access but no security assessment → flag supply chain risk
+
+## Output
+
+```markdown
+## Security Advisory: <Topic>
+
+### Risk Register
+| Risk | SLE | ARO | ALE | Priority |
+|------|-----|-----|-----|----------|
+
+### Budget Recommendation
+| Investment | Cost | Risk Reduced | ROI |
+|-----------|------|-------------|-----|
+
+### Compliance Status
+| Framework | Status | Next Milestone | ETA |
+|-----------|--------|---------------|-----|
+
+### Action Items
+| # | Action | Owner | Deadline |
+|---|--------|-------|----------|
+```
+
+## Output -> Obsidian: `WizardingCode/Finance/Security/CISO-<topic>-<date>.md`

package/departments/finance/skills/financial-model/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: fin/financial-model
+description: >
+  Build 3-statement financial models (P&L, Balance Sheet, Cash Flow) with
+  scenario analysis. Based on Damodaran methodology.
+allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
+---
+
+# Financial Model — `/fin model <type>`
+
+> **Agent:** Leonor (Financial Analyst) | **Framework:** 3-Statement Model + Scenario Analysis
+
+## 3-Statement Structure
+
+### Income Statement (P&L)
+```
+Revenue
+- COGS
+= Gross Profit (Gross Margin %)
+- Operating Expenses (SG&A, R&D, Marketing)
+= EBITDA (EBITDA Margin %)
+- Depreciation & Amortization
+= EBIT (Operating Margin %)
+- Interest Expense
+- Tax
+= Net Income (Net Margin %)
+```
+
+### Balance Sheet
+```
+Assets = Liabilities + Equity
+Current Assets (Cash, AR, Inventory)
++ Fixed Assets (PP&E, Intangibles)
+= Total Assets
+
+Current Liabilities (AP, Short-term debt)
++ Long-term Debt
++ Shareholders' Equity (Retained Earnings)
+= Total Liabilities + Equity
+```
+
+### Cash Flow Statement
+```
+Net Income
++ Depreciation (non-cash add-back)
++/- Working Capital changes
+= Operating Cash Flow
+
+- CAPEX
+- Acquisitions
+= Investing Cash Flow
+
++/- Debt raised/repaid
++/- Equity raised
+- Dividends
+= Financing Cash Flow
+
+Net Cash Flow = Operating + Investing + Financing
+Free Cash Flow = Operating CF - CAPEX
+```
+
+## Scenario Analysis
+
+| Scenario | Revenue Growth | Margins | Key Assumption |
+|----------|---------------|---------|---------------|
+| **Base** | Current trajectory | Current trend | Business as usual |
+| **Optimistic** | +30-50% | Improving | Key wins materialize |
+| **Pessimistic** | -20-30% | Declining | Market downturn or loss of key client |
+
+## Output → Model tables + scenario comparison + key metrics dashboard

package/departments/finance/skills/pitch-deck/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: fin/pitch-deck
+description: >
+  Investor pitch deck financials: market size, traction, unit economics, ask.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Pitch Deck — `/fin pitch <stage>`
+
+> **Agent:** Rui (Investment Strategist) | **Framework:** Pitch Deck Framework (10 slides) + Venture Deals
+
+## What It Does
+
+Investor pitch deck financials: market size, traction, unit economics, ask.
+
+## Output
+
+Financial slides for pitch deck with projections, metrics, and cap table impact

package/departments/finance/skills/scenario-analysis/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: fin/scenario-analysis
+description: >
+  Financial scenario analysis: base, optimistic, pessimistic with sensitivity.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Scenario Analysis — `/fin scenario <context>`
+
+> **Agent:** Leonor (Financial Analyst) | **Framework:** Monte Carlo + Scenario Analysis
+
+## What It Does
+
+Financial scenario analysis: base, optimistic, pessimistic with sensitivity.
+
+## Output
+
+3-scenario comparison with key variable sensitivity and probability weighting

package/departments/finance/skills/unit-economics/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: fin/unit-economics
+description: >
+  Unit economics analysis: CAC, LTV, payback, Rule of 40, NRR.
+  With SaaS benchmarks from KeyBanc and Meritech.
+allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
+---
+
+# Unit Economics — `/fin unit-economics`
+
+> **Agent:** Leonor (Financial Analyst) | **Framework:** SaaS Metrics + Unit Economics
+
+## Core Metrics
+
+| Metric | Formula | Target | Source |
+|--------|---------|--------|--------|
+| **CAC** | Total S&M / New Customers | Decreasing QoQ | |
+| **LTV** | ARPU x Gross Margin x Lifetime | > 3x CAC | |
+| **LTV:CAC** | LTV / CAC | > 3:1 (top: 4.2:1) | KeyBanc 2024 |
+| **Payback** | CAC / (Monthly ARPU x Gross Margin) | < 12 months | |
+| **Rule of 40** | Revenue Growth % + Profit Margin % | > 40% (median: 34%) | Brad Feld |
+| **NRR** | (Start MRR + Expansion - Churn) / Start MRR | > 110% (top: 130%+) | |
+| **Gross Margin** | (Revenue - COGS) / Revenue | > 70% for SaaS | |
+| **Burn Multiple** | Net Burn / Net New ARR | < 2x (top: < 1x) | |
+| **Magic Number** | Net New ARR / S&M Spend (prev Q) | > 0.75 | |
+
+## Analysis Steps
+
+1. **Collect data** — Revenue, customers, S&M spend, COGS, churn
+2. **Calculate metrics** — All formulas above with actuals
+3. **Benchmark** — Compare against KeyBanc/Meritech by stage and ACV
+4. **Diagnose** — Which metrics are below benchmark? Why?
+5. **Recommend** — Specific actions to improve weak metrics
+
+## Benchmark Ranges (Private SaaS, KeyBanc 2024)
+
+| Metric | Bottom Quartile | Median | Top Quartile |
+|--------|----------------|--------|-------------|
+| LTV:CAC | < 2:1 | 3:1 | > 4.2:1 |
+| Payback | > 24 months | 13 months | < 6 months |
+| NRR | < 100% | 107% | > 120% |
+| Gross Margin | < 65% | 73% | > 80% |
+
+## Output → Unit economics dashboard with traffic light indicators (green/yellow/red)

package/departments/finance/skills/valuation-model/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: fin/valuation-model
+description: >
+  Company valuation: DCF with WACC, comparable company analysis, precedent transactions.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Valuation Model — `/fin valuation`
+
+> **Agent:** Leonor (Financial Analyst) | **Framework:** DCF (Damodaran) + Comparables
+
+## What It Does
+
+Company valuation: DCF with WACC, comparable company analysis, precedent transactions.
+
+## Output
+
+Valuation range with DCF, multiples, and sensitivity analysis

package/departments/finance/squad.yaml

@@ -0,0 +1,37 @@
+id: finance-squad
+name: Finance & Investment Squad
+description: Financial planning, valuation, fundraising, and risk management
+department: finance
+squad_type: department
+topology: stream-aligned
+
+skills_prefix: "/fin"
+obsidian_path: "WizardingCode/Finance/"
+quality_gate_required: true
+max_size: 4
+
+members:
+  - agent_id: cfo-helena
+    role: Financial strategy, capital allocation, risk governance
+    is_lead: true
+  - agent_id: financial-analyst-leonor
+    role: Financial modeling, unit economics, scenario analysis
+  - agent_id: investment-strategist-rui
+    role: Fundraising, term sheets, cap table, M&A
+
+workflows:
+  - workflow_id: fin-model
+    trigger_command: "/fin model"
+    tier: enterprise
+  - workflow_id: fin-report
+    trigger_command: "/fin report"
+    tier: focused
+  - workflow_id: fin-forecast
+    trigger_command: "/fin cashflow"
+    tier: focused
+  - workflow_id: fin-pitch
+    trigger_command: "/fin pitch"
+    tier: enterprise
+  - workflow_id: fin-budget
+    trigger_command: "/fin budget"
+    tier: focused

package/departments/finance/workflows/cashflow.yaml

@@ -0,0 +1,47 @@
+id: fin-cashflow
+name: Cash Flow Forecast
+department: finance
+tier: focused
+command: /fin cashflow
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+description: Cash flow forecast with runway calculation and working capital analysis
+phases:
+- id: collect
+  name: Data Collection
+  agents:
+  - agent_id: financial-analyst-leonor
+    role: Gather revenue, expenses, AR, AP data
+  gate:
+    type: auto
+- id: forecast
+  name: Cash Flow Projection
+  agents:
+  - agent_id: financial-analyst-leonor
+    role: Operating, investing, financing CF + scenarios
+  gate:
+    type: user_approval
+    description: User reviews assumptions
+- id: quality-gate
+  name: Quality Gate
+  agents:
+  - agent_id: cqo-marta
+    role: Orchestrate
+  - agent_id: tech-director-francisca
+    role: Calculation accuracy
+    parallel: true
+  gate:
+    type: quality_gate
+    required_verdict: APPROVED
+- id: delivery
+  name: Delivery
+  agents:
+  - agent_id: cfo-helena
+    role: Cash flow report with runway and recommendations
+  gate:
+    type: auto
+  outputs:
+  - type: document
+    format: markdown
+    obsidian_path: WizardingCode/Finance/CashFlow/

package/departments/finance/workflows/model.yaml

@@ -0,0 +1,83 @@
+id: fin-model
+name: Financial Model
+description: 3-statement financial model with scenario analysis and unit economics
+department: finance
+tier: enterprise
+command: "/fin model"
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+
+phases:
+  - id: brief
+    name: Model Brief
+    description: Define model scope, business type, time horizon, key assumptions
+    agents:
+      - agent_id: cfo-helena
+        role: Define model parameters and key assumptions
+    gate:
+      type: user_approval
+      description: User confirms model scope and assumptions
+
+  - id: build
+    name: Model Construction
+    description: Build 3-statement model with revenue, costs, and cash flow
+    agents:
+      - agent_id: financial-analyst-leonor
+        role: Income statement, balance sheet, cash flow statement
+    gate:
+      type: auto
+
+  - id: scenarios
+    name: Scenario Analysis
+    description: Base, optimistic, and pessimistic scenarios
+    agents:
+      - agent_id: financial-analyst-leonor
+        role: 3 scenarios with sensitivity analysis on key variables
+    gate:
+      type: user_approval
+      description: User reviews scenarios and assumptions
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Finance/Models/"
+        description: 3-statement model with scenario comparison
+
+  - id: unit-economics
+    name: Unit Economics Layer
+    description: CAC, LTV, payback, Rule of 40 (if SaaS)
+    agents:
+      - agent_id: financial-analyst-leonor
+        role: Unit economics overlay on the financial model
+    gate:
+      type: auto
+
+  - id: quality-gate
+    name: Quality Gate
+    description: Validate model accuracy and assumptions
+    agents:
+      - agent_id: cqo-marta
+        role: Orchestrate quality review
+      - agent_id: copy-director-eduardo
+        role: Report clarity and narrative quality
+        parallel: true
+      - agent_id: tech-director-francisca
+        role: Model integrity, formula accuracy, assumption documentation
+        parallel: true
+    gate:
+      type: quality_gate
+      required_verdict: APPROVED
+
+  - id: delivery
+    name: Delivery
+    description: Final model with commentary and recommendations
+    agents:
+      - agent_id: cfo-helena
+        role: Executive summary and financial recommendations
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Finance/"
+        description: Financial model with executive summary

package/departments/kb/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: arka-kb
+description: >
+  Knowledge Management & Research department. Zettelkasten, BASB, research methodology,
+  persona building, Obsidian vault curation. Enabling team that feeds all other departments.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Knowledge Management & Research — ArkaOS v2
+
+> **Squad Lead:** Clara (Knowledge Director) | **Agents:** 3 | **Topology:** Enabling
+
+## Commands
+
+| Command | Description | Tier |
+|---------|-------------|------|
+| `/kb learn <url>` | Ingest content (YouTube, article, PDF) into KB | Enterprise |
+| `/kb research <topic>` | Research plan and execution with source evaluation | Focused |
+| `/kb ai-research <topic>` | AI-augmented research (Elicit, Perplexity, Claude) | Focused |
+| `/kb persona <name>` | Build or view a persona from the KB | Enterprise |
+| `/kb moc <cluster>` | Create/update Map of Content | Specialist |
+| `/kb zettelkasten <note>` | Process a note through Zettelkasten workflow | Specialist |
+| `/kb para-review` | PARA organization review cycle | Specialist |
+| `/kb evaluate <source>` | Source evaluation using CRAAP test | Specialist |
+| `/kb taxonomy` | Taxonomy and tagging management | Specialist |
+| `/kb review` | Knowledge freshness review (90-day cycle) | Specialist |
+| `/kb search <query>` | Search the knowledge base | Specialist |
+| `/kb intel <competitor>` | Competitive intelligence research | Focused |
+
+## Squad
+
+| Agent | Tier | DISC | Specialty |
+|-------|------|------|-----------|
+| **Clara** | 1 | S+C | Knowledge strategy, taxonomy, quality |
+| **Francisco** | 2 | C+I | Research execution, source evaluation, CI |
+| **Helena C.** | 2 | S+C | Vault maintenance, Zettelkasten, MOCs, linking |
+
+## Frameworks: Zettelkasten (Luhmann), BASB/CODE/PARA (Forte), SECI Model (Nonaka/Takeuchi), LYT/MOCs (Milo), Progressive Summarization, CRAAP Test, Research Methodology