Skip to content

Commit c34d844

Browse files
renezander030claude
andcommitted
README: composite-led adapters section + task-first (not second-brain) framing
- Intro states ATS is task-first, NOT a second-brain/PKM tool; supporting systems fused in as context behind tasks. Lists composite adapter. - Replace ~95 lines of per-adapter blurbs with one composite section (the cross-source story the demo gif shows) + a pointer to each package README. Per-adapter setup details already live in packages/adapter-*/README.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 186a721 commit c34d844

1 file changed

Lines changed: 24 additions & 93 deletions

File tree

README.md

Lines changed: 24 additions & 93 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,14 @@ curated, prioritized, deduplicated context, pre-filtered by the most reliable
4242
ranker there is — you.
4343

4444
ATS makes that context agent-native. **Adapter, not migration**: keep the system
45-
you already live in (TickTick, Taskmaster, Beads, Obsidian, or OKF bundles today) and give
46-
your agent a fast, structured, two-way channel into it.
45+
you already live in — TickTick, Taskmaster, Beads, Obsidian, Notion, GitHub, Airtable,
46+
Google, or all of them at once via the [composite adapter](packages/adapter-composite/)
47+
and give your agent a fast, structured, two-way channel into it.
48+
49+
**ATS is task-first.** It turns the task manager you run your work from into the agent's
50+
memory, with supporting systems (GitHub issues, Notion specs, docs) fused in as context
51+
behind each task. It is **not** a second-brain / PKM tool — the task is the spine; the
52+
supporting docs are there to serve it.
4753

4854
```bash
4955
npm install -g @reneza/ats-cli @reneza/ats-adapter-ticktick
@@ -307,102 +313,27 @@ ats adapter new linear # writes ats-adapter-linear/ (six stubs + pa
307313
ats adapter test ./ats-adapter-linear # pass/fail/skip per contract check
308314
```
309315

310-
### Taskmaster: search and context over repo-local agent tasks
311-
312-
The [Taskmaster adapter](packages/adapter-taskmaster/README.md) treats tags as projects, flattens subtasks into stable `<tag>:<id>` references, searches every native text field without model tokens, and exposes native dependencies as read-only `depends-on` context:
313-
314-
```bash
315-
git clone https://github.com/renezander030/agentic-task-system.git
316-
cd agentic-task-system && npm install
317-
cd /path/to/taskmaster-project
318-
ats config use /path/to/agentic-task-system/packages/adapter-taskmaster
319-
ats tasks search "upload limit" --json
320-
ats context master master:4
321-
cd /path/to/agentic-task-system && npm run prove:taskmaster
322-
```
323-
324-
### Beads: ATS context over the native issue graph
325-
326-
The [Beads adapter](packages/adapter-beads/README.md) calls the official `bd --json` CLI, maps native dependencies and parent-child edges into ATS context, and leaves Beads' Dolt database authoritative:
327-
328-
```bash
329-
npm install -g @reneza/ats-cli @reneza/ats-adapter-beads
330-
cd /path/to/beads-repository
331-
ats config use beads
332-
ats find "release blocker"
333-
ats context my-repo bd-a1b2
334-
```
335-
336-
Already shipped: the [Obsidian adapter](packages/adapter-obsidian/README.md) is
337-
a worked example of the contract over plain markdown — point ATS at a vault with
338-
`ATS_OBSIDIAN_VAULT` and `ats find` / `ats open` / `ats links` just work.
316+
### Composite: every backend as one cross-source corpus
339317

340-
The [OKF adapter](packages/adapter-okf/README.md) exposes Open Knowledge Format
341-
bundles as ATS projects and concept documents. Point it at a bundle with
342-
`ATS_OKF_BUNDLE` to query vendor-neutral markdown/frontmatter knowledge catalogs
343-
through the same retrieval, graph, and MCP surface.
344-
345-
### Airtable: any base as agent-queryable records
346-
347-
The [Airtable adapter](packages/adapter-airtable/README.md) maps a table to a
348-
project and a record to a task — the primary field becomes the title, the rest of
349-
the fields become the markdown body — so any base is searchable through `ats find`
350-
and MCP, fused by RRF with your other sources. Auth is a Personal Access Token
351-
scoped to only the bases you grant, keeping the blast radius small:
318+
The [composite adapter](packages/adapter-composite/README.md) is the cross-source layer —
319+
it's what the demo above runs. Point it at several child adapters and one `ats find` fuses
320+
GitHub + Notion + your task app into a single RRF-ranked list, each hit tagged with its
321+
backend. Connectors give your agent access to one tool each; this is the retrieval layer
322+
that searches all of them at once. Each child keeps its own auth; the composite holds none.
352323

353324
```bash
354-
npm install -g @reneza/ats-cli @reneza/ats-adapter-airtable
355-
export ATS_AIRTABLE_TOKEN=pat... ATS_AIRTABLE_BASES=appXXX
356-
ats config use @reneza/ats-adapter-airtable
357-
ats find "supplier reconciliation"
325+
npm install -g @reneza/ats-cli @reneza/ats-adapter-composite \
326+
@reneza/ats-adapter-github @reneza/ats-adapter-notion @reneza/ats-adapter-ticktick
327+
ats config use @reneza/ats-adapter-composite
328+
ats find "auth token migration" # one ranked list across every backend
358329
```
359330

360-
### Google: Sheets, Docs, and Slides as a read-only corpus
361-
362-
The [Google adapter](packages/adapter-google/README.md) pulls Google Sheets,
363-
Docs, and Slides into ATS retrieval as a read-only corpus — a doc type is a
364-
project, a file is a task, and the body is the extracted text (Sheets render as
365-
markdown tables). It authenticates as a **dedicated, read-only Workspace user**
366-
who only sees the files you share with them, so a leaked token can never reach the
367-
rest of anyone's Drive:
368-
369-
```bash
370-
npm install -g @reneza/ats-cli @reneza/ats-adapter-google
371-
ats config use @reneza/ats-adapter-google # then authLogin → authExchange as the dedicated user
372-
ats find "Q3 pricing model"
373-
```
374-
375-
### Notion: databases and pages as agent-queryable knowledge
376-
377-
The [Notion adapter](packages/adapter-notion/README.md) maps a database to a
378-
project and a page to a task — the page title is the title, the block tree renders
379-
to a markdown body — so the Notion specs and docs that *support your tasks* are
380-
searchable through `ats find` and fused in alongside them. Auth is an internal integration token, and the
381-
security boundary is Notion's own per-page sharing: the integration only sees the
382-
databases you explicitly share with it.
383-
384-
```bash
385-
npm install -g @reneza/ats-cli @reneza/ats-adapter-notion
386-
export ATS_NOTION_TOKEN=ntn_...
387-
ats config use @reneza/ats-adapter-notion
388-
ats find "auth migration runbook"
389-
```
390-
391-
### GitHub: issues and discussions as agent memory
392-
393-
The [GitHub adapter](packages/adapter-github/README.md) treats a repository as a
394-
project and an issue (or discussion) as a task — title, markdown body, and comment
395-
thread become one retrievable record, labels become tags. It's the cleanest fit
396-
for ATS's own audience: the issues you already use as scratchpads, ADRs, and RFC
397-
threads, now fused by meaning with your notes and tasks. Auth is a fine-grained PAT
398-
scoped to just the repos you grant, read-only:
399-
400-
```bash
401-
npm install -g @reneza/ats-cli @reneza/ats-adapter-github
402-
export ATS_GITHUB_TOKEN=github_pat_... ATS_GITHUB_REPOS=owner/repo
403-
ats config use @reneza/ats-adapter-github
404-
ats find "rate limit regression"
405-
```
331+
**Per-adapter setup — auth, mapping, error strings — lives in each package's own README**
332+
(linked from the table above): [Notion](packages/adapter-notion/README.md) ·
333+
[GitHub](packages/adapter-github/README.md) · [Airtable](packages/adapter-airtable/README.md) ·
334+
[Google](packages/adapter-google/README.md) · [Obsidian](packages/adapter-obsidian/README.md) ·
335+
[OKF](packages/adapter-okf/README.md) · [Taskmaster](packages/adapter-taskmaster/README.md) ·
336+
[Beads](packages/adapter-beads/README.md) · [TickTick](packages/adapter-ticktick/README.md).
406337

407338
The scaffold + conformance kit + interface doc make it a couple-hundred-line job for most well-behaved APIs.
408339

0 commit comments

Comments
 (0)