Glossary¶
Key terms used across the Liflode stack. Alphabetical order.
ADR (Architecture Decision Record)
: A document in liflode-docs/adr/ recording a system design decision — context, options considered, and rationale. Numbered ADR-NNN. Architecture only; tool selection rationale goes in the Neon tools table.
Blitz : Parallel execution mode where multiple Sonnet AI agents run independent issues simultaneously in isolated git worktrees. Used for batches of atomic, non-dependent tasks.
Canon
: The symbolic source of truth for Liflode entity types, relationships, and vocabulary. Stored in liflode-docs/canon/. Always write via the /canon skill — never edit YAML directly. Entity IDs use letter-prefix + 3-digit format (e.g. W-001, E-042) and are never reused.
Cloudflare Pages
: Liflode's static hosting platform. Repos (site-base, proposals) auto-deploy from GitHub on push to main via GitHub Actions.
Conventional Commits
: The commit message format used across all Curious-Owl11 repos. Format: <type>(<scope>): <description>. Common types: feat, fix, chore, docs, refactor. See conventions/branches-commits-prs.md for full details.
Crew
: The internal AI agent team — Dotti, Finn, and Blitz. Not contractor-facing. Issues labelled finn or dotti are in their queues. Crew agents operate in git worktrees and log to Linear.
Dotti : Haiku-class AI agent handling data queries, reporting, and admin tasks. The lightest-weight crew member — used for bulk API calls, status updates, and simple transforms.
Finn : Sonnet-class AI agent handling coding, implementation, and analysis tasks. Primary crew executor for IT and product work.
HITL (Human in the Loop)
: A checkpoint in an automated pipeline where a human must review or approve before the workflow continues. Tracked in Canon as H-NNN decision points.
Infisical
: The secrets management service at eu.infisical.com. All API keys and credentials are stored here. Never hardcode secrets in code or commit them to git. Scripts access secrets via infisical run --.
Initiative : The second level of the Linear hierarchy: Team > Initiative > Project > Issue. Determines "whose desk does this land on" — e.g. IT: Installation, RevOps: Grants, Content:.
ip_module (Innovation Portfolio Module)
: A reusable, brand-agnostic content or product building block. Tracked in the ip_modules table in Neon. Canon entity prefix M. Brands are applied as a rendering layer when creating final products — never baked into modules.
Linear
: The project management tool and single source of truth for all work tracking. All issues, projects, and sprints live here. URL: app.linear.app.
MkDocs
: The documentation site generator used for docs.liflode.com. Uses the Material theme. Content lives in liflode-docs/docs/.
Modal : Serverless burst compute platform for AI workloads (embeddings, proposal generation, context API). Used for jobs that need GPU or on-demand scale without a persistent server.
n8n : Event-driven automation tool running in local Docker. Used for webhooks, Linear event triggers, and human-in-the-loop workflows. Not for scheduled cron — that is Windmill's role. (ADR-044)
Neon : The canonical cloud Postgres database — authoritative source for clean, production data. Windmill, Modal, and Cloudflare Workers read from Neon. Local Postgres is staging/ETL only.
PMO (Project Management Office)
: The Claude agent layer responsible for work decomposition. All issue creation goes through /pmo or /pmo-auto. Claude never creates Linear issues directly outside of the /issue skill.
R2
: Cloudflare's S3-compatible object storage. Used for file archives, backups, exports, and unstructured data. Upload via rclone (not boto3 — Infisical R2 keys are used with rclone).
Windmill
: The scheduled job runner at app.windmill.dev (workspace: liflode). Used for cron jobs and ETL pipelines — code-first, not drag-and-drop. Complements n8n (which handles events). (ADR-044)
Worktree : A git feature used by Blitz agents — each agent checks out a separate working directory from the same repo, allowing parallel work on different issues without conflicts.