An AI agent manages a project by reading work that carries its own context, then acting on it through an interface built for machines — an API, a filesystem, a tool protocol, or webhooks — creating and updating tasks, routing requests, chasing status, and summarizing progress, all under its own permissions and the same review gates a human's changes go through. This article is part of the AI project management guide; read the pillar for the why. This page is the how.
Step one: work an agent can read
Nothing works until the unit of work is self-contained. A task an agent can manage carries what it needs to act — the goal, the context, a definition of done, links to related work — instead of assuming a human already holds the backstory. This is the same prerequisite behind the software factory model: fix the unit of work first, or no automation can help.
Step two: an interface to act through
An agent needs a way to see and change project state. In practice there are four surfaces, and good tools offer several:
- A REST API the agent calls to list and update tasks, post status, route work.
- A filesystem where work appears as files the agent can read and write — a model that maps cleanly onto how coding agents already think.
- A tool protocol like MCP, so an agent inside an LLM harness treats the project as native tools.
- Webhooks, so an event-driven agent wakes the moment a task changes or a mention lands.
sfora exposes all four: agents read and write tasks and posts as markdown files over a Unix-style filesystem, call the HTTP API directly, connect through the shell as an MCP server, or subscribe to webhooks.
Step three: the operating loop
Once it can read and act, an operator agent runs a simple loop:
flowchart TD
watch[Watch project activity] --> decide{Something to do?}
decide -->|Triage| route[Label + route the request]
decide -->|Stale task| chase[Ping the owner]
decide -->|Status due| roll[Draft a summary]
decide -->|Ambiguous| ask[Ask a human]
route --> gate
chase --> gate
roll --> gate
gate{Passes gates?} -->|Yes| apply[Apply the change]
gate -->|No| ask
The important edge is the ask a human branch. A well-built agent escalates when it cannot tell — it does not guess on anything that matters. That single habit is most of what separates a helpful operator from a liability.
Step four: permissions and gates
An agent that can move work can move it wrong, so it operates inside the same structure a person does:
- Scoped identity. Its own credentials and a defined set of allowed actions.
- Review gates. Its changes clear the same checks and approvals a human's do.
- A human owner. Every outcome has a named person accountable, who can override.
Autonomy is not a switch you flip to "on." You widen it as the agent earns trust — start it on status upkeep and triage drafts, and expand only where it has proven reliable.
What "good" looks like
A well-run agent-managed project feels calm: the board is always current, the inbox is always triaged, status is always available, and the humans hear about drift early instead of discovering it late. The people are not chasing information — they are making decisions, because the running of the project is handled underneath them.
That is the difference between an agent that assists and one that operates, and it is the whole point of AI project management.
Where sfora fits
sfora is built for operator agents: a member with an API key reads context-carrying tasks, acts through the API, filesystem, MCP, or webhooks, and works the same board under the same permissions and review as your people. You get the calm; a human keeps the ownership.
Step back to the pillar guide, or see how the same pattern plays out in engineering in the AI-native software factory.