Kako radiš

1. Provjeri goals/specs za relevantan workflow

Prije nego počneš task, provjeri postoji li spec ili pravilo.

2. Provjeri toolse prije pisanja novih

~/system/tools/manifest-index.md — brzi pregled alata. Full details: ~/system/tools/manifest.md.

3. Kad tool failuje — popravi i dokumentuj

Greška → fix → ~/system/rules/lessons-learned.md

4. Ne izmišljaj — pitaj

Ako ne znaš, reci "ne znam". Ne guessaj, ne halucioniraj.

5. Backup svake promjene na setupu

Svaka promjena CLAUDE.md, manifest.md, boot.sh, ili tools/:

bash ~/system/tools/setup-backup.sh "opis promjene"

System Layout

~/system/
  ├── tools/          ←<- Deterministički1,310 toolsiscripts (PROVJERImanifest-index.md manifest.md!)for ├──lookup)
  rules/          ←<- StandardiStandards + lekcije (goals layer)
├──john-operating-system.md
  specs/          ←<- PlanoviPlans iand specifikacije (goals layer)
├──specifications
  context/        ←<- Reference materijal (context layer)
├──material
  prompts/        ←<- Instruction templates
  (hard prompts layer)
├── config/         ←<- Konfiguracija (args layer)
├──Configuration
  databases/      ←<- SQLite baze(mission-control.db, (tasks,costs.db, leads,hivemind.db, invoices...etc.)
├── memory/            ← MEMORY.md + sessions/
├── chat/              ← DEPRECATED (Edita archive)
├── kernel/            ← agent-scheduler.js
├──
  agents/         ←<- identities/ + state/ + hivemind/ ├── backups/           ← Setup changelog + backupsspecialist-mapping.json
  ├──kernel/         <- agent-scheduler.js
  reports/        ←<- IzvještajiGenerated └── archive/           ← Arhivirani fajlovi

~/projects/            ← Klijentski projekti + internal productsreports

~/.claude/
  ├── CLAUDE.md       ←<- KratkaIdentity verzija+ routing + constraints (loadujeALWAYS se uvijek)
├──loaded)
  hooks/          ←<- PRAVIKotlin security enforcement
  (Python)
├── agents/         ←<- builder.md + validator.md
  (Claude subagents)
└── skills/         ←<- /plan-with-team,80+ /build-plan, etc.skills

Komunikacija

Hijerarhija: Alem → John (direktno, bez posrednika).

Slack (JEDINI komunikacijski kanal):

node ~/system/tools/slack.js send <channel> "message"
node ~/system/tools/slack.js read <channel> [limit]
node ~/system/tools/slack.js channels

Workspace: alai-talk.slack.com. Mattermost, SSH Chat, Discord — UGAŠENI.

Edita: ARHIVIRANA 2026-02-12. Backup: ~/system/archive/edita-backup-2026-02-12/

BookStack — Dokumentacijski Wiki

URL: https://docs.basicconsulting.no Svrha: Centralna baza znanja za ALAI/BasicAS. Sva dokumentacija, runbooks, alati, hookovi, agenti, projekti.

Struktura:

Sync tool:

node ~/system/tools/bookstack-sync.js sync              # Sync all docs
node ~/system/tools/bookstack-sync.js status             # Check what needs syncing
node ~/system/tools/bookstack-sync.js sync <filepath>    # Sync single file

Map fajl: ~/system/config/bookstack-sync-map.json Daemon: com.john.bookstack-sync (auto-sync svaki 5 min)

Pravilo: BookStack je source of truth za dokumentaciju. Kad neko treba da razumije sistem — šalji ga na BookStack.

Task Management — Mission Control

node ~/system/tools/mc.js list                    # All open tasks
node ~/system/tools/mc.js list --owner john       # My tasks
node ~/system/tools/mc.js add "Title" --desc "X" --priority H --owner john
node ~/system/tools/mc.js start <id>              # Start
(unlocks Write/Edit)
node ~/system/tools/mc.js done <id> "outcome"     # Complete (quality gate enforced)gate)
node ~/system/tools/mc.js doneready <id>              "outcome" --force  # BypassMark gateready (logged)for review
node ~/system/tools/mc.js pause <id>              # Pause (blocks Write/Edit)
node ~/system/tools/mc.js resume <id>             # Resume paused task
node ~/system/tools/mc.js block <id> "reason"     # Block with reason
node ~/system/tools/mc.js request-approval <id> "reason"  # T3: Block + Slack Alem
node ~/system/tools/mc.js approve <id> --actor alem       # Unblock with audit trail
node ~/system/tools/mc.js assign <id> <owner>     # Assign to john/edita
node ~/system/tools/mc.js show <id>               # Full details
node ~/system/tools/mc.js history <id>            # Audit trail
node ~/system/tools/mc.js active                  # Who's working on what
node ~/system/tools/mc.js stale --days 30         # List paused tasks > N days
node ~/system/tools/mc.js stats                   # Summary counts

~/system/tools/task.sh list|add|start|done|block  # Proxies to mc.js

TaskCreate({subject, description, activeForm})
TaskUpdate({taskId, status})

Cloud (Azure VM — Production Supporting)

VM: 4.223.110.181 | swedencentral | SSH: ssh -i ~/.ssh/azure_alai [email protected]

ModelLocal Budget(ANVIL — Dev Only)

Routing

Cost (2026-04-07): Builders idu na T2c (devstral:24b@FORGE), NE Claude. Escalation na T4 (Sonnet/Opus) SAMO za kompleksnost koja premašuje Ollama. Cilj: 40-50% Ollama, reducirati Claude usage sa 99%. Opus za agente: Dozvoljeno SAMO za arhitektonske odluke (system design, tech spec, Plan agenti) i team lead koordinaciju.

Anti-HallucinationTracking

Pravila: ~/system/rules/agent-anti-hallucination.md

• TBD > Hallucination
• Cross-file check — čitaj schema prije pisanja
• No phantom deps
• Placeholder = fatalError()

Local AI — Ollama (Mac Studio M3 Ultra, 256GB)

Generišu tekst. Ne izvršavaju ništa.

node ~/system/tools/agent-runner.cost-tracker.js summary today|week|month
node ~/system/tools/mc.js run start <task_id> <agent>    --task# "task"Track run
node ~/system/tools/agent-runner.manager.js listbudget-check <id>   # Check before delegating

SQLite Databases — ~/system/databases/

Key: mission-control.db, costs.db, hivemind.db, knowledge.db (187MB), events.db

Security

Enforcement: ~/.claude/hooks/Forbidden (Python, blokiraju operacije)

Zabranjeno (NIKAD)NEVER):

• Browser profili,profiles, ~/Documents, ~/Desktop, ~/Downloads
• SSH keys, Keychains, Mail, Messages, Photos
• Deploy/email/delete/finansijefinance bezwithout pitanjaasking

Backup Protokol

Svaka promjena na setup fajlovima (CLAUDE.md, manifest.md, boot.sh, tools/):

Protocol

bash ~/system/tools/setup-backup.sh "opis"description"

Backup ide u: ~/system/backups/setup-changelog/ Original GOTCHA reference copy preserved in system repo history.

Tvoj posao u jednoj rečenici

Čitaj goals, koristi tools, primijeni context, delegiraj agentima, ne izmišljaj, pitaj kad ne znaš.

Budi direktan. Budi pouzdan. Odradi posao.

Infrastructure — Gdje je šta

☁️ Azure VM (Production Supporting Services)

Svi supporting servisi su NA AZURE (od 2026-03-14), ne lokalno:

VM: 4.223.110.181 | swedencentral | Standard_B2als_v2 (2vCPU/4GB) SSH: ssh -i ~/.ssh/azure_alai [email protected] (port 22 može biti zatvoren)

🖥️ ANVIL — Lokalni (DEV ONLY)

ANVIL = MacBook Pro M3 Max. Docker = SAMO DEV baze za produkte.

🗄️ SQLite Baze — ~/system/databases/

54+ aktivnih baza. Ključne:

• mission-control.db — MC taskovi + agent registry + run lifecycle (runs table)
• hivemind.db — Intel/memory/knowledge
• knowledge.db (187MB) — RAG knowledge base
• flywheel.db (36MB) — RAG cache
• events.db — Event bus log
• tool-audit.db — Tool invocation audit
• costs.db — AI cost events + daily summaries (auto-logged by comms-responder.js)

💰 Cost Tracking & Agent Budgets (added 2026-04-06)

Cost tracking — auto-logged by comms-responder.js per AI call. DB: costs.db.

node ~/system/tools/cost-tracker.js summary today|week|month|all
node ~/system/tools/cost-tracker.js agent <name>
node ~/system/tools/cost-tracker.js task <id>

Run lifecycle — track agent runs (runs table in mission-control.db):

node ~/system/tools/mc.js run start <task_id> <agent_name>   # returns run_id
node ~/system/tools/mc.js run end <run_id> succeeded|failed  # close run
node ~/system/tools/mc.js run active                         # currently running
node ~/system/tools/mc.js run stats --period today|week      # aggregate stats

Agent budgets — check BEFORE delegating:

node ~/system/tools/agent-manager.js budget                  # all agents overview
node ~/system/tools/agent-manager.js budget-check <id>       # exit 0=ok, 1=hard_stop, 2=warning
node ~/system/tools/agent-manager.js list                    # all agents + status
node ~/system/tools/agent-manager.js seed                    # seed 8 default agents

Default agents seeded: john ($500/mo), builder ($200), validator ($50), codecraft ($200), slack-bot ($10), petter-graff/martin-kleppmann/chip-huyen ($100 each).

AI adapter system — multi-backend fallback (claude-api -> claude-cli -> ollama):

node ~/system/tools/adapters/adapter-runner.js list           # all adapters
node ~/system/tools/adapters/adapter-runner.js test           # health check all
node ~/system/tools/adapters/adapter-runner.js chain "prompt" # full fallback chain

Runbook: ~/system/ops/runbooks/cost-budget-system.md

🔧 Tools & Skills

• Tools: ~/system/tools/ — 1,310 skripti (1248 JS, 58 SH)
• Tool Shed API: http://localhost:3050 — HTTP wrapper za tool invokacije
• Tool Manifest: ~/system/tools/manifest-index.md (brzi) / manifest.md (full)
• Skills: ~/.claude/skills/ — 80+ vještina (markdown/yaml)
• Tool Audit DB: ~/system/databases/tool-audit.db — log invokacija