Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Foam project memory — measured AI agent skill | DecimalAI

chatondearu/foam-project-memory

SkillScore86Maintained

Bootstrap and maintain a Foam-style project memory graph (ADR, PRD, plans) at repo-root foam/, wired to GitHub Kanban. Use when starting project memory, recording architecture decisions, drafting PRDs/plans, importing kanban issues into foam, or before product/architecture changes so the agent can challenge against accepted ADRs.

by chatondearu

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Knowledge Management pack

decimalai skills pull chatondearu-foam-project-memory

Get this skill — curl · raw file

curl -fsSL https://app.decimal.ai/s/chatondearu-foam-project-memory/SKILL.md

Raw file: /s/chatondearu-foam-project-memory/SKILL.md ↗ · machine-readable summary at /s/chatondearu-foam-project-memory.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 7d ago

Yes — +50% lift+4% tokens0% turns86% of whole cases pass with skill (19/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-09	✗→✓	▲ Improved	-20%	0%
case-10	✗→✓	▲ Improved	19%	0%
case-04	✗→✓	▲ Improved	7%	0%
case-05	✗→✓	▲ Improved	-47%	0%
case-07	✗→✓	▲ Improved	-1%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/1/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

chatondearu / ai-dev-kit

skills/foam-project-memory/SKILL.md

View on GitHub ↗

Imported 8/1/2026Version v1Bundled 2 files · scripts

Skill contents

scripts/

SKILL.md

Foam project memory

Announce at start: "Using foam-project-memory skill."

What this is

A versioned knowledge graph in Markdown (wikilinks [[note]]) so agents and humans share the same memory:

| Layer | Path | Role | | ----- | ---- | ---- | | Foam graph | foam/ | MOC, ADRs, product notes, feature catalog | | PRD | prd/ | What / why per feature | | Plan | plans/ | How / when (checklist derived from PRD) | | Kanban | GitHub Projects | Execution status (use github-kanban-orchestrator) |

foam/ is agent decision memory. User-facing docs may live elsewhere (doc/, README.md) — do not duplicate; link from foam/ when needed.

Bootstrap a repository

From the target repo root:

bash
# preview
bash "$(dirname "$0")/scripts/init.sh" --dry-run

# scaffold (never commits — you git add/commit when ready)
bash "$(dirname "$0")/scripts/init.sh"

# import closed/open issues from GitHub into foam/features/
bash "$(dirname "$0")/scripts/import-kanban.sh"

init.sh copies templates only. It does not run git commit — you decide when to commit the scaffold.

Agent protocol (every product/architecture task)

Read foam/index.md (Map of Content).
Search foam/decisions/ for related ADRs (grep tags or keywords).
If a PRD exists under prd/ for this work, follow it.
If a plan exists under plans/, use it as the implementation checklist.
If the user requests something that contradicts an accepted ADR, cite the

ADR and ask whether to supersede it (new ADR required).

Workflows

A — New feature

Kanban: issue in Ready (github-kanban-orchestrator).
Copy prd/template.md → prd/PRD-NNN-slug.md; link ADRs + foam notes.
Copy plans/template.md → plans/PLAN-NNN-slug.md.
Implement; PR with Closes #NNN.
On merge: PRD → shipped; add row to foam/features/shipped.md; new

technical choice → new ADR.

B — Architecture decision

Copy foam/decisions/ADR-template.md → foam/decisions/ADR-NNN-slug.md.
Fill context, decision, alternatives rejected, consequences.
Add row to foam/decisions/index.md and foam/index.md.
Link from relevant foam/architecture/*.md notes.

C — Sync from Kanban

bash
bash scripts/import-kanban.sh          # refresh shipped + backlog indexes
bash scripts/import-kanban.sh --dry-run

Regenerates foam/features/shipped.md and foam/features/backlog.md from gh issue list. Re-run after milestones or when onboarding a repo.

D — Import historical decisions (one-off)

For mature repos: read closed issues + CHANGELOG + AGENTS.md gotchas → distill into ADRs and PRDs (do not dump every issue as an ADR).

Integration with github-kanban-orchestrator

| Kanban | Foam | | ------ | ---- | | Issue #N title/body | PRD source material | | Status Done | Row in foam/features/shipped.md | | Epic / backlog | foam/features/backlog.md + prd/PRD-NNN-*.md | | Claim + branch | plans/PLAN-NNN-*.md checklist |

Layout (repo root)

foam/
  index.md              # start here
  README.md
  decisions/            # ADRs
  product/                # vision, rules
  features/               # shipped / backlog catalog
  architecture/           # topic guides (optional)
prd/
plans/
.foam/templates/          # Foam editor templates
.cursor/rules/
  product-memory.mdc      # project rule (copied on init)

Additional material

conventions.md — naming, statuses, tags
reference.md — ADR/PRD/plan templates explained
templates/scaffold/ — files copied by init.sh

Want to see if chatondearu/foam-project-memory would activate on your phrasing? Try it before you install — no LLM call, no signup.

Other measured skills in the registry, with their headline benchmark lift.