Core concepts
A short glossary, in the order they show up in real life. Most pages in these docs assume you know these eight words.
Workspace
The top-level place your team lives. A workspace owns its members, its email setup, and one or more projects.
Project
A unit of work — usually one repository or one product. A project has its own briefs, intakes, agents, members and workflow rules.
Intake
A configured channel for receiving briefs. Each project can have several. Five built-in types: web form, iOS feedback, email, Sentry webhook, planning form.
Brief
One piece of work. Has a state, a type, a priority, an assignee, an AI confidence, attachments and a full timeline of what happened to it.
Agent
A helper with one job. Lithify ships with four — flagging (filter spam), refining (clean up briefs), coding (write code), mailer (send notifications).
Workflow rule
A "when this happens, if this is true, then do this" rule. The way Lithify gets opinionated about your briefs without you writing any code.
API key
How machines authenticate. Belongs to a project, carries scopes that say what it can do.
Initiative
A bigger piece of work that splits into a tree of child briefs — a feature, a redesign, an audit. Same audit and lifecycle discipline as a brief.
How they fit together
A workspace contains projects. A project receives submissions through intakes. Each submission becomes a brief. Workflow rules listen for things happening to briefs and tell agents what to do. When the coding agent gets a brief, Lithify takes care of the rest — branching the repo, making the change, opening a PR for a human to review.
workspace
└── project
├── intakes (web form, iOS, email, Sentry, planning)
├── agents (flagging, refining, coding, mailer)
├── workflow rules (when → if → then)
├── members (you, teammates, agents)
└── briefs (the actual work) Two ideas worth holding on to
Agents never decide where a brief goes next. They do their job and leave a record. The workflow is what decides — promote, route, notify, cancel. You can change either part without breaking the other.
Everything is on the timeline. Every state change, every agent run, every reviewer note shows up in chronological order on the brief. If you ever need to ask "why did this happen?", the answer is one click away.