Skip to content

@raea/task and docs/plan.feature: a project's plan.org as typed tasks; skills pin raea-skills #75 - #154

Merged
shinyobjectz merged 3 commits into
mainfrom
plan-sdk-014
Nov 15, 2026
Merged

shinyobjectz merged 3 commits into
mainfrom
plan-sdk-014

Conversation

@shinyobjectz

Copy link
Copy Markdown
Owner

The plan of a project's work: one Org file at the top of the project's folder (plan.org), the to-do list the person sees in the app and the one every agent keeps.

  • sdk/task (@raea/task): reads plan.org losslessly (any text back byte for byte), gives its tasks as typed values, and edits them by task id (add, set, state, move, remove, check). Plugins add keyword sequences, properties, kinds and views; board, agenda and outline ship; ./react has hooks and components. No runtime dependencies.
  • docs/plan.feature: PL1 to PL6, what the app, the agents and the SDK do.
  • skills pin: raea-skills App steps: { frames: N } and { dialog: N } play again #75 (skills/raea/plan.md, SKILL.md section 0 step 5, the plan tools in collaborate.md and reference/feed.md).

The app side is raea-feed integration-014 (tasks-org merged at 1214a21). Checked: bun test in sdk/task 32 of 32; the CI gates in a clean export of main with these files all pass.

shinyobjectz and others added 3 commits November 14, 2026 18:34
…, read and written by task id

The plan of a project's work (Shane 11-14: "i like org mode for managing projects ... integrates well with
typescript/react/jsx"): one Org file at the top of the project's folder, the to-do list the person sees in the app and
the one every agent keeps. sdk/task reads it losslessly (parseOrg/printOrg give back any text byte for byte: CRLF,
tabs, unknown drawers, LOGBOOK, blocks, tables, no final newline), gives its tasks as typed values (ids, keywords,
priority, tags, dates, :ITEM:, :AGENT:, :FROM:, subtasks, checkboxes, progress cookies, links by id), and edits it by
task id (add, set, state, move, remove, check: ids minted, CLOSED stamped, cookies recounted, untouched lines kept, a
bad edit throws and changes nothing). Plugins add keyword sequences, properties, kinds and views; board, agenda and
outline ship. planDigest and the plan tools' answers serve any host; ./react has usePlan, useView and the outline,
agenda and board components. No runtime dependencies.

docs/plan.feature PL1 to PL6 says what the app, the agents and the SDK do. The app is raea-feed integration-014
(tasks-org merged, 1214a21) and the skill raea-skills #75.

Checked: bun test (org, edit, extend, tools) 32 of 32; with its React tests under the app's vitest, 35; the gates in
a clean export of main with these files (layers, names, size, one-version, no-void, dupes, rask, sdk coverage, sdk
props, taxonomy) all pass.
… the project's plan.org; SKILL.md section 0 step 5 opens the project's plan once in its folder; the plan tools in collaborate.md and reference/feed.md (generated from raea-feed integration-014 1214a21)
@shinyobjectz
shinyobjectz merged commit d870159 into main Nov 15, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant