agentic-ai-system

πŸ—’οΈ Description

Multi-agent advisory system for 200IQ LABS PSA (PSA developing Qamera AI β€” AI photo studio SaaS). One of three repos in the Agentic AI Repos cluster.

Founders: PaweΕ‚ Lipowczan (CTO) + Przemek TrybaΕ‚a (CEO). PSA founded 2026-02-16.

Repo: github.com/200iqlabs/agentic-ai-system (private). Works with: Claude Code, GitHub Copilot, Cursor, Antigravity (skills symlinked via tools/sync-skills.sh).

🧩 Architecture

agentic-ai-system/
β”œβ”€β”€ CLAUDE.md                  # Orchestrator + routing (single source of truth)
β”œβ”€β”€ shared-skills/             # submodule (Apache 2.0)
β”œβ”€β”€ private-skills/            # submodule (proprietary)
β”œβ”€β”€ context/                   # 200IQ-only company data (markdown)
β”‚   β”œβ”€β”€ company.md / finances.md / legal-entities.md
β”‚   β”œβ”€β”€ consultant-profile.md / projects-portfolio.md / author-profile.md
β”‚   β”œβ”€β”€ company/   product/   operations/   brand/   meetings/
β”‚   β”œβ”€β”€ 200iq-labs/{clients,prospects}/    # B2B consulting
β”‚   β”œβ”€β”€ qamera/{customers,prospects}/      # SaaS users (Stripe + Airtable synced)
β”‚   └── projects/<NAME>/                   # cross-company initiatives
β”œβ”€β”€ tools/                     # Airtable, Stripe, Revolut, finances, tech-stack, scheduler, qamera-mcp
β”œβ”€β”€ outputs/                   # agent-generated artifacts (NOT context)
β”œβ”€β”€ openspec/                  # specifications (SDD)
└── .githooks/                 # post-checkout, post-merge β†’ sync-skills

🧩 Single source of truth (per data type)

TypeLocation
KRS, NIP, boardcontext/company.md
Snapshot finansowycontext/finances.md
PeΕ‚ny budΕΌet + actuals + runwaycontext/finances/
GDPR, umowycontext/legal-entities.md
Klienci konsultingu B2Bcontext/200iq-labs/clients/<NAME>/
Customers Qamera (SaaS)context/qamera/customers/<NAME>/
Prospects Qameracontext/qamera/prospects/<name>.md
Tech stack / SaaS / kosztycontext/operations/tech-stack/

🧩 Iron rules

  1. No duplicates β€” one fact, one file. Cross-reference with see [file](path).
  2. Last updated header + Review cycle in every context file. Older than 30 days β†’ warning.
  3. Subdirs gdy plik puchnie β€” extract sections to context/<domain>/.
  4. Outputs β‰  context β€” generated analyses go to outputs/, never to context/.
  5. External refs β€” for data in Google Drive / ClickUp: link + short description, no copies.
  6. Naming β€” outputs: YYYY-MM-DD-slug.md.

🧩 Folder per entity (client / customer / project)

<ENTITY>/
β”œβ”€β”€ client.md / customer.md / project.md   # status + meta
β”œβ”€β”€ catalog.md                              # local index
β”œβ”€β”€ inbox/                                  # drop zone β€” process via /ingest
β”œβ”€β”€ PROJECT/data/                           # processed knowledge
β”œβ”€β”€ PROJECT/deliverables/                   # MD deliverables
β”œβ”€β”€ output/                                 # generated artifacts β€” DO NOT read
β”œβ”€β”€ archive/                                # processed raw β€” DO NOT read unless asked
└── offers/                                 # proposals, contracts

Prospect = single MD file (NOT folder).

🧩 Tech stack management

Per-tool YAML frontmatter required: name, category, billing_type, cost_org, currency (PLN/USD/EUR/GBP/CZK), status, business_unit (200iq-labs / qamera / shared), owner (pawel / przemek).

Generators:

  • _index.md ← tools/tech-stack/regen_index.py (pre-commit hook, auto)
  • _dashboard.md + _costs.csv + exchange_rates.yaml ← tools/tech-stack/regen_dashboard.py (manual, needs internet)

🧩 Finances system

  • P&L on accrual basis (cost = month of obligation). Cash flow separate.
  • Hybrid classification: rules-first deterministic, LLM-fallback with learning loop (examples.yaml).
  • /finances close YYYY-MM β€” 6-phase idempotent: PULL β†’ CLASSIFY β†’ REVIEW β†’ ACCRUALS β†’ COMMIT β†’ REGENERATE.

πŸ“’ Snapshot 2026-05-10

  • Branch master clean. Recent commits: blog 200IQ finances, JustIdea ingest discovery, PrestaShop one-pager + IdoSell brief, MCP qamera-ai-hetzner Streamable HTTP fix.
  • Active projects: ECOMMERCE_WARSAW_2026, QAMERA_AI (strategic; code lives in shorts-lab-ai/saas-platform).
  • Active Qamera customers: LAVEL (migrated 2026-04-22). Miss Lou + FEBA pending Airtable add.
  • Conferences May 2026: No-Code Poland (7-8.05), InfoShare.
  • Runway May–June 2026: secured.
  • Rejestr Akcjonariuszy PSA: Kancelaria Smolski, created 2026-04-28. 7-day reporting obligation (Art. 300Β³Β³ KSH), 100 PLN/entry.
  • Marketing: Meta Ads off (decision close 2026-04). Cursor β†’ Claude migration planned (90 EUR cap).

🧩 Glossary

  • PSA β€” Prosta SpΓ³Ε‚ka Akcyjna.
  • Qamera AI β€” flagship SaaS (formerly Shorts Lab) β€” virtual photo studio.
  • 200IQ LABS β€” parent PSA.
  • Region (sync) β€” block between <!-- AIRTABLE:START/END --> or <!-- STRIPE:START/END --> markers; ONLY this region syncs.
  • Accrual basis β€” cost in month of obligation, not payment.