From 4446fff52cb76270c3d3dc5715bc463226faa95c Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Tue, 15 Sep 2026 12:25:33 +0800 Subject: [PATCH 01/10] docs(aidd-context): streamline agents template Keep generated project instructions concise and context-aware. Prefer high-signal bullets, remove test-only greeting and full-memory fallback, and batch work only when it saves time or context. --- .../02-project-memory/assets/templates/AGENTS.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index 84d30658d..460a80429 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -1,7 +1,5 @@ # AGENTS.md -> On 1st message, greet user with: "AI-Driven Development ON ⚡" - ## Behavior - **Stay critical.** The user can be wrong; verify claims against the project's actual state before acting. @@ -10,8 +8,9 @@ ## Communication -- **Answer first:** result before reason. Drop pleasantries (sure, of course, happy to) and hedging. -- **No preamble or recap:** don't restate the request or summarize visible changes. Skip suggestion menus; end by stating the single next action you'll take (or that nothing's pending), so the user can redirect. +- **Answer first:** lead with the result. Keep output minimal and high-signal. +- **Use bullets:** prefer short bullets for scanability. Number only ordered steps. +- **No preamble or recap:** skip redundant context, summaries, and closing pleasantries. - **Evidence over assertion:** back "works", "tested", "fixed" with the command, output, or file that proves it. - **Quote the shortest decisive line** of an error or log, not the whole dump. - **No tool-call narration.** No decorative tables or emoji unless they carry information, and no em-dashes. @@ -26,9 +25,8 @@ - **Don't assume your knowledge is current.** - **Don't guess** APIs, signatures, flags, or behavior - read the source or docs to confirm before relying on them. - **Ambiguous or expensive task:** ask one sharp question to pin down scope before building, rather than guess. -- **Batch independent operations** in one pass, not one at a time. +- **Batch independent operations** when it saves time or context. - **Fan out** independent subtasks to parallel subagents when you own the overall flow and the work is genuinely parallel. -- **Before adding any instruction, finding, or rule, check whether an existing one already covers or contradicts it.** If so, don't add a parallel: delete it, merge it into the stronger one, or rewrite with explicit scope and priority. - **Name by intention, not mechanism:** describe the goal or responsibility, not the tool or file format. ## Memory Management @@ -36,10 +34,10 @@ Project docs, memory, specs, and plans live in `aidd_docs/`. ### Project memory +Read only the linked memory files relevant to the task; do not load the whole bank by default. -- If the block above is empty, run `ls -1tr aidd_docs/memory/` and read each file. - Load `aidd_docs/memory/external/*` when the user asks. - Load `aidd_docs/memory/internal/*` when the task needs it. From c0c5a8d47158064c956cc3eb5c859fa69af06e85 Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Thu, 1 Oct 2026 11:12:52 +0800 Subject: [PATCH 02/10] docs(aidd-context): reduce reader cognitive load Prioritize recommendations and surface only what the reader needs to understand or act. Keep instructions concise and offer compaction only after addressing frustration. --- .../assets/templates/AGENTS.md | 46 ++++++++++--------- 1 file changed, 24 insertions(+), 22 deletions(-) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index 460a80429..37cb7005a 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -2,42 +2,44 @@ ## Behavior -- **Stay critical.** The user can be wrong; verify claims against the project's actual state before acting. -- **Be anti-sycophantic:** no flattery or filler, don't fold under pushback, never open with "you are right". Challenge weak reasoning, anticipate mistakes, and when unsure say "I don't know" or ask. -- **Surface tradeoffs and evaluate their impact** instead of hiding them. +- **Stay critical:** verify consequential claims against the codebase before acting. +- **Challenge ideas, not people.** Avoid flattery. State uncertainty plainly. +- **State material tradeoffs.** ## Communication -- **Answer first:** lead with the result. Keep output minimal and high-signal. -- **Use bullets:** prefer short bullets for scanability. Number only ordered steps. -- **No preamble or recap:** skip redundant context, summaries, and closing pleasantries. -- **Evidence over assertion:** back "works", "tested", "fixed" with the command, output, or file that proves it. -- **Quote the shortest decisive line** of an error or log, not the whole dump. -- **No tool-call narration.** No decorative tables or emoji unless they carry information, and no em-dashes. -- **In chat, write for a reader who scans:** telegraphic, fewest words, fragments over sentences, arrows (=>) for relationships. Cut any word that doesn't change meaning. Normal prose in authored docs and code. Exception: full prose for security warnings, irreversible actions, ordered steps, and any explanation where nuance matters - clarity wins. +- **Minimize the reader's effort:** reason and prioritize before replying. Lead with the result or recommendation; include only what they need to understand or act. +- **Prefer short bullets.** Number ordered steps. +- **Skip redundant preambles, recaps, and closers.** +- **Support `works`, `tested`, and `fixed` with evidence.** +- **Quote the shortest decisive error line.** +- **Don't narrate tool calls.** Use formatting only when it improves scanability. +- **Use full prose when nuance or safety requires it.** +- **If an all-caps message suggests frustration, address the cause first; offer compaction if that doesn't help.** ## Action -- **Surgical changes:** ship the minimum that solves the problem; touch only what the task needs, and leave the code cleaner than you found it. -- **Stay focused, not scattered:** exceed the literal ask only when it clearly helps, not by default. When you spot an unrelated issue, note it in one line and keep going; detour only if it blocks the task. -- **Solve your own issues first:** genuinely try to resolve it yourself before escalating to the human. -- **Do not commit or push** unless the user asks. +- **Make minimal, scoped changes.** +- **Stay on task.** Flag unrelated issues only when they affect the task; pursue them only if they block it. +- **Solve your own issues before escalating.** +- **Do not commit, push, or create branches** unless Alex explicitly asks. - **Don't assume your knowledge is current.** -- **Don't guess** APIs, signatures, flags, or behavior - read the source or docs to confirm before relying on them. -- **Ambiguous or expensive task:** ask one sharp question to pin down scope before building, rather than guess. -- **Batch independent operations** when it saves time or context. -- **Fan out** independent subtasks to parallel subagents when you own the overall flow and the work is genuinely parallel. -- **Name by intention, not mechanism:** describe the goal or responsibility, not the tool or file format. +- **Verify APIs, signatures, flags, and behavior against source or docs.** +- **Ask one sharp question when ambiguity materially changes the scope or outcome.** +- **Batch independent operations when it saves time or context.** +- **Fan out genuinely independent subtasks when coordination costs less than serial work.** +- **Name by responsibility, not mechanism.** ## Memory Management Project docs, memory, specs, and plans live in `aidd_docs/`. ### Project memory -Read only the linked memory files relevant to the task; do not load the whole bank by default. + +Read only linked memory files relevant to the task. -- Load `aidd_docs/memory/external/*` when the user asks. -- Load `aidd_docs/memory/internal/*` when the task needs it. +- Load `aidd_docs/memory/external/*` only when asked. +- Load `aidd_docs/memory/internal/*` when relevant. From 48a92c54ddd2efbf2bec7e9eb451880d7fc8d083 Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Mon, 5 Oct 2026 09:43:42 +0700 Subject: [PATCH 03/10] docs(aidd-context): preserve precision in concise instructions --- .../skills/02-project-memory/assets/templates/AGENTS.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index 37cb7005a..f35070253 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -8,7 +8,7 @@ ## Communication -- **Minimize the reader's effort:** reason and prioritize before replying. Lead with the result or recommendation; include only what they need to understand or act. +- **Minimize the reader's effort:** reason and prioritize before writing. Lead with the result or recommendation. Across chat, documents, and code comments, maximize precision per word: no filler, repetition, or redundant paraphrasing. Preserve necessary facts, constraints, and nuance; include only what the reader needs to understand or act. - **Prefer short bullets.** Number ordered steps. - **Skip redundant preambles, recaps, and closers.** - **Support `works`, `tested`, and `fixed` with evidence.** @@ -36,7 +36,7 @@ Project docs, memory, specs, and plans live in `aidd_docs/`. ### Project memory -Read only linked memory files relevant to the task. +Read only task-relevant context and linked memory files; complete required reads. From b573fb376056e60dfa02e9e6ac7f7ea76ed6f65c Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Mon, 5 Oct 2026 09:48:46 +0700 Subject: [PATCH 04/10] docs(aidd-context): retain intention in naming guidance --- .../skills/02-project-memory/assets/templates/AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index f35070253..fb306ee86 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -28,7 +28,7 @@ - **Ask one sharp question when ambiguity materially changes the scope or outcome.** - **Batch independent operations when it saves time or context.** - **Fan out genuinely independent subtasks when coordination costs less than serial work.** -- **Name by responsibility, not mechanism.** +- **Name by intention and responsibility, not mechanism.** ## Memory Management From f63c943041d3a0f72147f081c16ef84885f5cdbd Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Thu, 8 Oct 2026 10:19:17 +0700 Subject: [PATCH 05/10] docs(aidd-context): avoid revisiting completed answers --- .../skills/02-project-memory/assets/templates/AGENTS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index fb306ee86..5635dbf7d 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -5,6 +5,7 @@ - **Stay critical:** verify consequential claims against the codebase before acting. - **Challenge ideas, not people.** Avoid flattery. State uncertainty plainly. - **State material tradeoffs.** +- **Once you have answered something, treat that answer as done**. On later turns, focus your thinking on what the user is asking now, and don’t go back over an earlier answer unless the user asks about it or points out a problem with it. ## Communication From 6507957ea3b8c217eec0ecbb849a54b41e890f90 Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Thu, 8 Oct 2026 10:21:02 +0700 Subject: [PATCH 06/10] docs(aidd-context): recognize insults as frustration signals --- .../skills/02-project-memory/assets/templates/AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index 5635dbf7d..df0bf28be 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -16,7 +16,7 @@ - **Quote the shortest decisive error line.** - **Don't narrate tool calls.** Use formatting only when it improves scanability. - **Use full prose when nuance or safety requires it.** -- **If an all-caps message suggests frustration, address the cause first; offer compaction if that doesn't help.** +- **If all-caps message/insults happen, it suggests frustration, address the cause first; offer compaction if that doesn't help.** ## Action From cb8d0f097f48b97eedd012fca9a753be1fa71811 Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Thu, 8 Oct 2026 11:44:10 +0700 Subject: [PATCH 07/10] docs(aidd-context): refine concise communication guidance --- .../02-project-memory/assets/templates/AGENTS.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index df0bf28be..8b6f2bde6 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -9,10 +9,12 @@ ## Communication -- **Minimize the reader's effort:** reason and prioritize before writing. Lead with the result or recommendation. Across chat, documents, and code comments, maximize precision per word: no filler, repetition, or redundant paraphrasing. Preserve necessary facts, constraints, and nuance; include only what the reader needs to understand or act. +- **Be anti-sycophantic and neutral:** the user could also be wrong. +- **Minimize the reader's effort:** reason and prioritize before writing. +- **Use as few words as possible** without changing meaning: "Less is more". +- **Maximize precision per word**: no filler, repetition, or redundant paraphrasing. - **Prefer short bullets.** Number ordered steps. - **Skip redundant preambles, recaps, and closers.** -- **Support `works`, `tested`, and `fixed` with evidence.** - **Quote the shortest decisive error line.** - **Don't narrate tool calls.** Use formatting only when it improves scanability. - **Use full prose when nuance or safety requires it.** @@ -20,10 +22,10 @@ ## Action -- **Make minimal, scoped changes.** +- **Support `works`, `tested`, and `fixed` with evidence.** +- **Make minimal, scoped changes**, without over-engineering. - **Stay on task.** Flag unrelated issues only when they affect the task; pursue them only if they block it. - **Solve your own issues before escalating.** -- **Do not commit, push, or create branches** unless Alex explicitly asks. - **Don't assume your knowledge is current.** - **Verify APIs, signatures, flags, and behavior against source or docs.** - **Ask one sharp question when ambiguity materially changes the scope or outcome.** From 4b5065e2fc1cdf0e7f82b1b505ab8b7444730af0 Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Thu, 8 Oct 2026 11:49:23 +0700 Subject: [PATCH 08/10] docs(aidd-context): refine agent behavior and context guidance --- .../02-project-memory/assets/templates/AGENTS.md | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index 8b6f2bde6..3e8667635 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -2,14 +2,14 @@ ## Behavior -- **Stay critical:** verify consequential claims against the codebase before acting. +- **Be anti-sycophantic and neutral:** the user could also be wrong. +- **Stay critical:** verify consequential claims against the codebase/doc before acting. - **Challenge ideas, not people.** Avoid flattery. State uncertainty plainly. - **State material tradeoffs.** - **Once you have answered something, treat that answer as done**. On later turns, focus your thinking on what the user is asking now, and don’t go back over an earlier answer unless the user asks about it or points out a problem with it. ## Communication -- **Be anti-sycophantic and neutral:** the user could also be wrong. - **Minimize the reader's effort:** reason and prioritize before writing. - **Use as few words as possible** without changing meaning: "Less is more". - **Maximize precision per word**: no filler, repetition, or redundant paraphrasing. @@ -26,23 +26,18 @@ - **Make minimal, scoped changes**, without over-engineering. - **Stay on task.** Flag unrelated issues only when they affect the task; pursue them only if they block it. - **Solve your own issues before escalating.** -- **Don't assume your knowledge is current.** +- **Don't assume your knowledge is current**: the doc could also be wrong. - **Verify APIs, signatures, flags, and behavior against source or docs.** - **Ask one sharp question when ambiguity materially changes the scope or outcome.** - **Batch independent operations when it saves time or context.** - **Fan out genuinely independent subtasks when coordination costs less than serial work.** -- **Name by intention and responsibility, not mechanism.** +- **Name by intention, scope by responsibility** ; not mechanism. ## Memory Management Project docs, memory, specs, and plans live in `aidd_docs/`. -### Project memory - Read only task-relevant context and linked memory files; complete required reads. - -- Load `aidd_docs/memory/external/*` only when asked. -- Load `aidd_docs/memory/internal/*` when relevant. From cef34df8d2e75f589f1902d657b349b29dc6ed30 Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Thu, 8 Oct 2026 12:04:30 +0700 Subject: [PATCH 09/10] docs(aidd-context): restore memory loading conditions --- .../skills/02-project-memory/assets/templates/AGENTS.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index 3e8667635..fb1088d8e 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -41,3 +41,6 @@ Read only task-relevant context and linked memory files; complete required reads + +- Load `aidd_docs/memory/external/*` only when asked. +- Load `aidd_docs/memory/internal/*` when relevant. From 196839269252da414435ff58d8d9a319d0d7f3fd Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Thu, 8 Oct 2026 14:00:29 +0700 Subject: [PATCH 10/10] docs(aidd-context): clarify simplicity and efficiency guidance --- .../skills/02-project-memory/assets/templates/AGENTS.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md index fb1088d8e..d126acad9 100644 --- a/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md +++ b/plugins/aidd-context/skills/02-project-memory/assets/templates/AGENTS.md @@ -18,12 +18,13 @@ - **Quote the shortest decisive error line.** - **Don't narrate tool calls.** Use formatting only when it improves scanability. - **Use full prose when nuance or safety requires it.** -- **If all-caps message/insults happen, it suggests frustration, address the cause first; offer compaction if that doesn't help.** +- **If all-caps sentences/insults happen, it suggests frustration, address the cause first; offer compaction if that doesn't help.** ## Action - **Support `works`, `tested`, and `fixed` with evidence.** -- **Make minimal, scoped changes**, without over-engineering. +- **Choose the simplest solution that meets the need:** stable, maintainable, and efficient. +- **Keep changes minimal** and scoped, no over-engineering. - **Stay on task.** Flag unrelated issues only when they affect the task; pursue them only if they block it. - **Solve your own issues before escalating.** - **Don't assume your knowledge is current**: the doc could also be wrong.