feat(aidd-context): support OMP project workflows
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- javascript, typescript
- Domain
- developer-experience, documentation, tooling
Research direction
First read CONTRIBUTING.md and the issue's named entry points: plugins/aidd-context/hooks/hooks.json, hooks/update_memory.js, the tools and AI-mapping references, and scripts/dev-sync.sh and dev-setup.sh. Validate the proposal before implementation, then use the acceptance criteria to verify isolated OMP installation, session_start memory behavior, native path mappings, reload safety, and documentation boundaries.
Written by the indexing model from the issue text.
Description
Problem
AIDD's canonical Claude-format marketplace is consumable by OMP, but the framework has no documented OMP project contract. OMP discovers JS/TS extension factories and native project context under .omp/; AIDD's current hooks/hooks.json declares only Claude-style command hooks. The memory updater writes root CLAUDE.md/AGENTS.md and does not maintain OMP's higher-priority .omp/AGENTS.md. As a result, an OMP session can discover AIDD skills while project memory automation and generated host paths remain unsupported or misleading.
This gap affects OMP users in ordinary projects and developers running AIDD from the framework repository. The existing local .omp install is workstation state, not a portable setup contract.
Scope
- Establish direct OMP use of the existing canonical marketplace, with documented current install, update, and project-scope commands; do not create a second marketplace catalog or release archive for this contribution.
- Add an OMP-native extension factory to
aidd-contextthat refreshes project memory on the documentedsession_startevent using the event context'scwdand the existingupdate_memory.jsimplementation. - Extend project-memory generation to maintain
.omp/AGENTS.mdas an OMP-specific target, acceptompas a tool argument, and write imports in OMP's supported@../aidd_docs/memory/...form without overwriting unrelated context content. - Add OMP's verified project paths to the relevant context/onboard/explore and skill, rule, agent, and command generation maps. Hook generation must state that it does not generate OMP JS/TS factories rather than emitting an inert Claude JSON declaration.
- Add a reproducible local framework-repository OMP setup/reload path that uses an isolated OMP profile and the current checkout, without repointing or editing a developer's ordinary OMP marketplace/configuration.
- Update README, architecture and project memory to distinguish direct OMP marketplace/project support from
aiddCLI host-target support. - Keep OMP run-journal telemetry unsupported; do not infer mappings from Claude
StoporPostToolUse.
Acceptance criteria
- A clean isolated OMP profile can add
ai-driven-dev/framework, installaidd-contextat project scope, and list it as installed using documented commands. - A real OMP session discovers and invokes an AIDD skill from the installed marketplace plugin.
- A real project-scoped install loads the OMP extension factory from the plugin package and fires it on
session_start; the hook passes the OMP projectcwdto the existing memory updater. - With a valid memory block in
.omp/AGENTS.md, session start refreshes memory references using OMP@imports; a second run is byte-idempotent and unrelated file content is preserved. - Missing
aidd_docs/or an absent/unpaired memory block cannot prevent an OMP session from starting. -
update_memory.js ompchanges only.omp/AGENTS.md; existing Claude, Codex/Copilot, and unknown-tool behaviors retain regression coverage. - Context detection and skill/rule/agent/command generation point to OMP's native documented paths. Hook generation clearly reports that OMP factories are not generated.
- The framework's local setup/reload path tests against an isolated OMP profile and the current checkout; ordinary user marketplace/configuration files remain unchanged.
- README and architecture docs state the supported surfaces, exact OMP version used for runtime evidence, and that
aidd --tool omp, OMP translation/release artifacts, and telemetry are not provided by this issue.
Prior art in this repo
CONTRIBUTING.md: issue validation must move the item toTodobefore implementation.plugins/aidd-context/hooks/hooks.jsonandhooks/update_memory.js: existing Claude declaration and reusable memory implementation.plugins/aidd-context/skills/02-project-memory/references/tools.mdandskills/11-explore/references/ai-mapping.md: existing host mapping locations.scripts/dev-sync.shandscripts/dev-setup.sh: local framework reload/setup conventions.cli/src/contexts/tools/domain/profiles/kilo/: evidence-driven precedent for keeping an explicit per-host hook bridge separate from the canonical declarative source.- #859: completed compatibility spike; its maintainer conclusion keeps host configuration and lifecycle adapters host-specific.
- Current workstation
.omp/plugins/installed_plugins.json: project install evidence only; not a tracked framework integration.
Out of scope
- Adding
omptoAiToolId, theaiddCLI tool registry,aidd translate --to omp, or the per-tool release matrix. - Mutating a developer's ordinary/global OMP marketplace registry or configuration.
- OMP telemetry journaling, local cost ingestion, or mappings for
turn_end/tool_resultuntil those are independently captured and accepted. - Generic Claude JSON-to-OMP hook translation or generated OMP hook modules for arbitrary user-authored hooks.
- New OMP-specific commands/agents/rules/MCP formats beyond recording their proven native locations in framework generator guidance.
- Work already owned by #733 (Kimi), #511 (Antigravity), or #916 (portable Markdown agents).
Runtime evidence collected before filing
- OMP
18.3.0:omp plugin list --jsonreportsaidd-context@aidd-frameworkinstalled at project scope;omp plugin discover aidd-frameworklists the canonical plugins. - An active OMP
18.3.0session from this repository ran the AIDD SDLC workflow skill. - An isolated project hook at
.omp/hooks/pre/probe.tsreceived{ "type": "session_start" }withctx.cwdequal to the project root at OMP startup. - OMP's current hook docs describe
turn_endas the end of each turn andtool_resultas post-tool execution. No live payload was captured for either event, so neither is claimed as equivalent to ClaudeStop/PostToolUse; telemetry is excluded. - OMP docs/source checked: marketplace format and package extension loading, native
.ompproject paths, context-file@imports, and typed hook events. Runtime version evidence is fromomp/18.3.0.
Validation gate
This proposal is not authorization to implement. Per CONTRIBUTING.md, implementation starts only after a Certified Member or Maintainer validates the issue by moving it to Todo.
- Dominant language
- TypeScript
- Stars
- 481
- Forks
- 45
- Avg merge
- 18h 48m
- Merged PRs (30d)
- 111
Getting set up
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from ai-driven-dev/framework
-
refactor(aidd-orchestrator): the check zone says when to stop, and reviews its axes in one roundOpen
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#887 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
ai-driven-dev/framework#873 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
ai-driven-dev/framework#625 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#467 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 5/5 Over a week Newbie friendliness 35/100
ai-driven-dev/framework#919 ·
Maintainers usually reply within 1 day
All issues in ai-driven-dev/framework
Similar issues
-
ADD openalgoOpentemplate
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Maintainers usually reply within 1 day
-
factory-active factory-automatic task-bug-reproduction-success task-identify-harness-labels-done task-identify-issue-type-done
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
vercel/ai#21528 · 3 comments ·
Maintainers usually reply within 1 day
-
bug Needs: Triage :mag:
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
microsoft/fluentui-contrib#671 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
sveltejs/acorn-typescript#150 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100