Set up a repository
Connect your tracker
Bring work from Jira, Linear, or GitHub into the repository as a spec or brief, without writing back to the tracker.
Install the pack for your tracker, then name an issue, and your agent reads it. Intake never writes to the tracker.
Pick your tracker
Section titled “Pick your tracker”Install core plus the pack for your tracker (see Install packs), then use the matching request:
| Tracker | Pack | First request |
|---|---|---|
| Jira | atlassian | Intake Jira issue PROJ-123 as repository work. |
| Jira Align | atlassian | Intake Jira Align Feature 4521 as repository work. |
| Linear | linear | Intake Linear issue LIN-123 as repository work. |
| GitHub | github | Intake GitHub issue 123 as repository work. |
GitHub also needs the gh CLI, signed in.
Run the first intake
Section titled “Run the first intake”Ask your agent, adding “Start read-only” so nothing is written:
Intake Linear issue LIN-123 as repository work. Start read-only.The agent reads the item and decides from its content, not its type, whether it becomes a spec, a brief, or a bug fix, and asks before it writes anything.
Keep planning in the repository
Section titled “Keep planning in the repository”If you shape work in the repository and want the tracker to mirror it, install product-engineering and ask:
Decompose this intent and show me the tracker projection for its slices.Pick one direction per body of work, because edits made in both places are never reconciled for you. Project slices to a tracker covers this direction.