@@ -42,8 +42,14 @@ curated, prioritized, deduplicated context, pre-filtered by the most reliable
4242ranker there is — you.
4343
4444ATS 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
4955npm install -g @reneza/ats-cli @reneza/ats-adapter-ticktick
@@ -307,102 +313,27 @@ ats adapter new linear # writes ats-adapter-linear/ (six stubs + pa
307313ats 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
407338The scaffold + conformance kit + interface doc make it a couple-hundred-line job for most well-behaved APIs.
408339
0 commit comments