# The Workflow at a Glance



<a id="section-steps"></a>

## Six steps

A Context task follows the same six steps whether it covers one document set or several repositories. You talk to the Agent; the Agent follows the workflow the CLI returns.

```mermaid
flowchart LR
  s1["1 Install"] --> s2["2 Initialize"]
  s2 --> s3["3 Research and plan"]
  s3 -->|work-start report| s4["4 Produce"]
  s4 --> s5["5 Review and preview"]
  s5 -->|revise| s4
  s5 -->|approve| s6["6 Build and commit"]
```

| Step | What you do | What happens |
| --- | --- | --- |
| 1 Install | Install the CLI and plugin once | Entries appear in your Agent host; see [Installation](</context/llms/pages/53535d85f2a932c36ba6afe78b0443ee.txt>) |
| 2 Initialize | Ask `/c4a:context` to create a Context knowledge workspace in a directory | The CLI creates `src/`, `sources/`, `knowledge/` and the guidance in `AGENTS.md` |
| 3 Research and plan | Describe the knowledge, its sources and its intended form, then answer the Agent's questions | The Agent registers sources, investigates them and presents a **work-start report**: confirmed configuration and scope, the planned content, and the expected package or site layout |
| 4 Produce | Wait, or ask for a local preview at any time | The Agent writes articles bound to source evidence and reports progress against the task count |
| 5 Review and preview | Read the review report and approve, reject or ask for revisions | Approved candidates become durable Markdown under `knowledge/` |
| 6 Build and commit | Confirm the package and other outputs | Context verifies and builds; the Agent commits the knowledge workspace to Git |


<a id="section-durations"></a>

## What to expect

Production is the longest step: on average each writing task takes about a minute. Ask for a preview whenever you want to see pages in a browser. The work-start report and the review report are the two moments where your judgment shapes the result most; the Guides section on review explains what to look for.


<a id="section-lanes"></a>

## Production, updates and questions

The six steps describe a first production round. Two other paths reuse the same knowledge workspace:

- **Updates.** Building completes the currently approved state; it does not freeze the knowledge workspace. When sources change, a new round reopens only the affected knowledge. See [Keeping Knowledge Current](</context/llms/pages/5ab69e04925afb8be867ea65ed680f86.txt>).
- **Questions.** `/c4a:context-inspect-search` answers questions from knowledge packages or approved knowledge in the knowledge workspace and traces each answer back to its sources.


<a id="section-loop"></a>

## Why you can stop and resume

Each step is chosen from the knowledge workspace's actual state, not from the conversation. After every action the CLI observes the knowledge workspace again and returns the current step, its required reading and the exact commands. If you close the conversation and invoke `/c4a:context` later, it resumes where the work actually is. See [Workflow Execution](</context/llms/pages/6c0213d0f56d7a7b8fc1a5724b8fc6b1.txt>).

---

## Sources

- note:20261012/usage-practices.md · usage-practices.md L5–L9
- [context/README.md L80–L92 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/README.md#L80-L92>)
- [context/packages/context-cli/docs/quickstart.md L67–L72 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/docs/quickstart.md#L67-L72>)
- note:20261012/usage-practices.md · usage-practices.md L8–L8
- note:20261012/usage-practices.md · usage-practices.md L16–L22
- [context/packages/context-cli/README.md L123–L124 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/README.md#L123-L124>)
- [context/plugins/context/skills/context-inspect-search/SKILL.md L1–L3 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/plugins/context/skills/context-inspect-search/SKILL.md#L1-L3>)
- [context/packages/context-cli/README.md L80–L111 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/README.md#L80-L111>)
- [context/README.md L94–L97 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/README.md#L94-L97>)