/*============================================================================*/

/*============================================================================*/
/* SKILL SKILL :: VERILINGUA x VERIX EDITION                      */
/*============================================================================*/

---
name: skill
version: 1.0.0
description: |
  [assert|neutral] Daily financial tracking with burn rate calculation, runway projection, and alert thresholds [ground:given] [conf:0.95] [state:confirmed]
category: financial-survival
tags:
- general
author: system
cognitive_frame:
  primary: evidential
  goal_analysis:
    first_order: "Execute skill workflow"
    second_order: "Ensure quality and consistency"
    third_order: "Enable systematic financial-survival processes"
---

/*----------------------------------------------------------------------------*/
/* S0 META-IDENTITY                                                            */
/*----------------------------------------------------------------------------*/

[define|neutral] SKILL := {
  name: "skill",
  category: "financial-survival",
  version: "1.0.0",
  layer: L1
} [ground:given] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/
/* S1 COGNITIVE FRAME                                                          */
/*----------------------------------------------------------------------------*/

[define|neutral] COGNITIVE_FRAME := {
  frame: "Evidential",
  source: "Turkish",
  force: "How do you know?"
} [ground:cognitive-science] [conf:0.92] [state:confirmed]

## Kanitsal Cerceve (Evidential Frame Activation)
Kaynak dogrulama modu etkin.

/*----------------------------------------------------------------------------*/
/* S2 TRIGGER CONDITIONS                                                       */
/*----------------------------------------------------------------------------*/

[define|neutral] TRIGGER_POSITIVE := {
  keywords: ["skill", "financial-survival", "workflow"],
  context: "user needs skill capability"
} [ground:given] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/
/* S3 CORE CONTENT                                                             */
/*----------------------------------------------------------------------------*/

# Runway Dashboard

## Kanitsal Cerceve (Evidential Frame Activation)
Kaynak dogrulama modu etkin.



Real-time financial tracking with burn rate analysis, runway projection, and critical alert thresholds. Know exactly how many weeks you can operate.

## Overview

Single-agent dashboard that calculates:
- **Current liquid assets** (checking, savings, available credit)
- **Monthly burn rate** (fixed + variable expenses)
- **Revenue streams** (Guild workshops, consulting, hackathons, grants)
- **Runway remaining** (weeks until zero)
- **Alert thresholds** (30-day warning, 60-day caution, 90-day safe)

**Critical for**: Survival planning, decision-making under financial pressure

## Assigned Agent

**analyst (FinTracker role)** - Daily financial snapshot and projection
- Expertise: Financial modeling, trend analysis, forecasting
- Tools: CSV processing, arithmetic, projection algorithms
- Output: Daily dashboard with runway visualization

## Data Flow

```
SKILL: runway-dashboard
  ↓
analyst (FinTracker) executes daily
  ↓
COMMANDS:
  - Read accounts.yml (current balances)
  - Read expenses.yml (monthly burn)
  - Read revenue_streams.yml (income)
  - Calculate runway = assets / (burn - revenue)
  - Generate markdown dashboard
  - Store snapshot in Memory MCP
  ↓
OUTPUT: Daily dashboard + 30/60/90-day projections
```

---

## Daily Execution Script

```bash
#!/bin/bash
# Runway Dashboard - Daily Financial Snapshot

# PRE-TASK HOOK
npx claude-flow@alpha hooks pre-task \
  --description "Runway: daily financial snapshot" \
  --agent "analyst" \
  --role "FinTracker" \
  --skill "runway-dashboard"

# SETUP
TODAY=$(date +%Y-%m-%d)
MONTH=$(date +%Y-%m)
mkdir -p outputs/dashboards raw_data/runway

# READ FINANCIAL DATA
CHECKING=$(yq eval '.accounts.checking.balance' data/finances/accounts.yml)
SAVINGS=$(yq eval '.accounts.savings.balance' data/finances/accounts.yml)
CREDIT_AVAIL=$(yq eval '.accounts.credit.available' data/finances/accounts.yml)

FIXED_EXPENSES=$(yq eval '.monthly.fixed | to_entries | map(.value) | add' data/finances/expenses.yml)
VARIABLE_EXPENSES=$(yq eval '.monthly.variable | to_entries | map(.value) | add' data/finances/expenses.yml)

GUILD_REVENUE=$(yq eval '.streams.guild.monthly_avg' data/finances/revenue_streams.yml)
CONSULTING_REVENUE=$(yq eval '.streams.consulting.monthly_avg' data/finances/revenue_streams.yml)
OTHER_REVENUE=$(yq eval '.streams.other.monthly_avg' data/finances/revenue_streams.yml)

# CALCULATIONS
TOTAL_ASSETS=$(echo "$CHECKING + $SAVINGS" | bc)
MONTHLY_BURN=$(echo "$FIXED_EXPENSES + $VARIABLE_EXPENSES" | bc)
MONTHLY_REVENUE=$(echo "$GUILD_REVENUE + $CONSULTING_REVENUE + $OTHER_REVENUE" | bc)
NET_BURN=$(echo "$MONTHLY_BURN - $MONTHLY_REVENUE" | bc)

# Runway in weeks (handle negative net burn = infinite runway)
if (( $(echo "$NET_BURN <= 0" | bc -l) )); then
  RUNWAY_WEEKS="∞ (revenue > expenses)"
else
  RUNWAY_WEEKS=$(echo "scale=1; ($TOTAL_ASSETS / $NET_BURN) * 4.33" | bc)
fi

# Alert status
if (( $(echo "$RUNWAY_WEEKS < 4" | bc -l) )); then
  ALERT_STATUS="🔴 CRITICAL (< 4 weeks)"
  ALERT_ACTION="IMMEDIATE ACTION REQUIRED"
elif (( $(echo "$RUNWAY_WEEKS < 8" | bc -l) )); then
  ALERT_STATUS="🟠 WARNING (< 8 weeks)"
  ALERT_ACTION="Accelerate revenue generation"
elif (( $(echo "$RUNWAY_WEEKS < 13" | bc -l) )); then
  ALERT_STATUS="🟡 CAUTION (< 13 weeks)"
  ALERT_ACTION="Monitor closely, prepare backup plans"
else
  ALERT_STATUS="🟢 SAFE (> 13 weeks)"
  ALERT_ACTION="Normal operations"
fi

# GENERATE DASHBOARD
cat > outputs/dashboards/runway_${TODAY}.md <<DASHBOARD
# Financial Runway Dashboard - $TODAY

$ALERT_STATUS

---

## Current Status

| Metric | Value |
|--------|-------|
| **Liquid Assets** | \$$(printf "%.2f" $TOTAL_ASSETS) |
| **Monthly Burn** | \$$(printf "%.2f" $MONTHLY_BURN) |
| **Monthly Revenue** | \$$(printf "%.2f" $MONTHLY_REVENUE) |
| **Net Burn** | \$$(printf "%.2f" $NET_BURN) |
| **Runway Remaining** | **$RUNWAY_WEEKS weeks** |
| **Alert Status** | $ALERT_STATUS |

---

## Asset

/*----------------------------------------------------------------------------*/
/* S4 SUCCESS CRITERIA                                                         */
/*----------------------------------------------------------------------------*/

[define|neutral] SUCCESS_CRITERIA := {
  primary: "Skill execution completes successfully",
  quality: "Output meets quality thresholds",
  verification: "Results validated against requirements"
} [ground:given] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/
/* S5 MCP INTEGRATION                                                          */
/*----------------------------------------------------------------------------*/

[define|neutral] MCP_INTEGRATION := {
  memory_mcp: "Store execution results and patterns",
  tools: ["mcp__memory-mcp__memory_store", "mcp__memory-mcp__vector_search"]
} [ground:witnessed:mcp-config] [conf:0.95] [state:confirmed]

/*----------------------------------------------------------------------------*/
/* S6 MEMORY NAMESPACE                                                         */
/*----------------------------------------------------------------------------*/

[define|neutral] MEMORY_NAMESPACE := {
  pattern: "skills/financial-survival/skill/{project}/{timestamp}",
  store: ["executions", "decisions", "patterns"],
  retrieve: ["similar_tasks", "proven_patterns"]
} [ground:system-policy] [conf:1.0] [state:confirmed]

[define|neutral] MEMORY_TAGGING := {
  WHO: "skill-{session_id}",
  WHEN: "ISO8601_timestamp",
  PROJECT: "{project_name}",
  WHY: "skill-execution"
} [ground:system-policy] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/
/* S7 SKILL COMPLETION VERIFICATION                                            */
/*----------------------------------------------------------------------------*/

[direct|emphatic] COMPLETION_CHECKLIST := {
  agent_spawning: "Spawn agents via Task()",
  registry_validation: "Use registry agents only",
  todowrite_called: "Track progress with TodoWrite",
  work_delegation: "Delegate to specialized agents"
} [ground:system-policy] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/
/* S8 ABSOLUTE RULES                                                           */
/*----------------------------------------------------------------------------*/

[direct|emphatic] RULE_NO_UNICODE := forall(output): NOT(unicode_outside_ascii) [ground:windows-compatibility] [conf:1.0] [state:confirmed]

[direct|emphatic] RULE_EVIDENCE := forall(claim): has(ground) AND has(confidence) [ground:verix-spec] [conf:1.0] [state:confirmed]

[direct|emphatic] RULE_REGISTRY := forall(agent): agent IN AGENT_REGISTRY [ground:system-policy] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/
/* PROMISE                                                                     */
/*----------------------------------------------------------------------------*/

[commit|confident] <promise>SKILL_VERILINGUA_VERIX_COMPLIANT</promise> [ground:self-validation] [conf:0.99] [state:confirmed]