rstillwell/ubiquitous-invention
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
ubiquitous-invention/plans
History
Randall Stillwell e99aa733c9 chore(agent-coordination): wire Cursor MCP + one-shot importer for dogfooding 
Connect Echodo to itself: Cursor sessions can now call this repo's MCP
server (`claim_task`, `complete_task`) over stdio, and operators can
bootstrap the DB from `plans/` without leaving a long-running file
watcher in place.

- `.cursor/mcp.json`: register `echodo` MCP server. Spawns
  `pnpm -s --filter @tasks/mcp-server mcp`. The `mcp` script invokes tsx
  with `--env-file=../../.env` so DATABASE_URL is picked up at the
  per-session process boundary without leaking into committed config.
- `import:markdown-backlog`: new one-shot importer (sibling of the
  existing watch script). Until the DB → markdown export side lands
  (see follow-up task), running the watcher continuously would clobber
  agent-driven status flips on every sweep. The one-shot variant runs a
  single `syncMarkdownBacklogScan` pass and exits.
- File `Task-export-db-to-markdown-frontmatter.md` documenting the
  remaining direction of the sync loop.

Smoke-tested end-to-end against the homelab DB: full `claim_task` →
`complete_task` round-trip via real MCP stdio protocol, with agent_runs
+ audit_log rows landing as expected and the backlog item status
restored via `finalStatus`.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-03 08:57:21 -05:00
..
Plan-agent-coordination chore(agent-coordination): wire Cursor MCP + one-shot importer for dogfooding 2026-06-03 08:57:21 -05:00
Plan-daily-driver-finish docs(plan): note agent-side prep on collab-editor smoke-test task 2026-06-02 00:26:34 -05:00
Plan-multitenant-cursor-sync feat: ECHODO app shell, Coolify deploy, Authentik + Umami 2026-04-26 14:34:34 -05:00
Plan-multitenant-saas-hardening feat(audit): append-only audit_log, workspace archive cascade + restore, audit view 2026-06-02 15:35:16 -05:00
README.md feat: ECHODO app shell, Coolify deploy, Authentik + Umami 2026-04-26 14:34:34 -05:00

README.md

Plans directory

Human- and agent-oriented backlog. Structure:

plans/
  Plan-<plan-slug>/
    Plan-<plan-slug>.md
    Epic-<epic-slug>/
      Epic-<epic-slug>.md
      Task-<task-slug>.md
      Task-<other-task>.md
  • Slug: lowercase, hyphenated, stable across renames of display title when possible.
  • Templates: copy from docs/templates/.
  • Chunking: keep each Task small enough for one Cursor agent or subagent to own; use Epics for milestones that need several tasks.

See docs/Glossary.md and config/CursorSync.md.

Import to database: from the repo root, with DATABASE_URL and your workspace UUID:

pnpm --filter @tasks/database watch:markdown-backlog

Set MARKDOWN_BACKLOG_WORKSPACE_ID (and optionally MARKDOWN_BACKLOG_REPO_ROOT). This runs an initial sync and watches plans/ for changes.