feat(framework): template override mechanism for skill templates
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 55/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- typescript
- Domain
- documentation, tooling
Research direction
Start by locating the skills that read bundled assets/*-template.md files and the aidd-context:03-context-generate scaffold entry point. Trace how each template is selected, then inspect aidd-context:02-project-memory on next and seed aidd_docs/overrides/README.md. Done means all template reads use the documented project, home-directory, then bundled cascade, including empty files, while non-template files remain unchanged.
Written by the indexing model from the issue text.
Description
Problem
Plugins ship skills with bundled assets/*-template.md files. A team that wants its own wording has one option today: edit the template in place. Every plugin update then overwrites it or conflicts.
Scope
- Cascade, first match wins:
aidd_docs/overrides/<plugin>/<skill>/<file>→~/.aidd/overrides/<plugin>/<skill>/<file>→ the bundledassets/<file>. - An override replaces the whole file. A present file is used even when empty: presence is the selection.
- Retrofit every skill that reads a
*-template.mdwith the cascade. aidd-context:03-context-generateinjects the cascade when it scaffolds a new template-shipping skill.- Seed
aidd_docs/overrides/README.mdso a user finds the mechanism.
Acceptance criteria
- A project override survives a plugin update, with no conflict and no re-edit.
- With no override present, every skill behaves exactly as today.
- An empty override file is honoured as an override, not ignored as blank.
- A skill scaffolded after this lands ships the cascade without the author writing it.
Out of scope
Only assets/*-template.md is overridable. Actions, references, SKILL.md and frontmatter stay frozen.
No drift detection: an override applies silently even when the bundled template changes upstream. Accepted, and worth its own issue if it bites.
Note
The original issue named aidd-context:02-project-init as the skill that seeds the override doc. That skill no longer exists — it is aidd-context:02-project-memory on next.
- Dominant language
- TypeScript
- Stars
- 481
- Forks
- 45
- Avg merge
- 14h 27m
- Merged PRs (30d)
- 111
Contributor guide
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 round Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#887 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
ai-driven-dev/framework#873 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
ai-driven-dev/framework#872 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
ai-driven-dev/framework#625 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#467 · 1 comment ·
All issues in ai-driven-dev/framework
Similar issues
-
blocklist removal
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
MetaMask/eth-phishing-detect#296544 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
pastelsky/bundlephobia#1122 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
category/development priority/P2 scope/file-operations scope/testing type/enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Enatega Customer and Rider app: Add-ons price is not visible to customer after order is placed. Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100