diff --git a/.devops/js-tools/README.md b/.devops/js-tools/README.md index d97091b..4f5ca6f 100644 --- a/.devops/js-tools/README.md +++ b/.devops/js-tools/README.md @@ -29,9 +29,9 @@ Review the diff after `lint:fix`; not every rule is safely fixable. ## Count Tokens The token tally helper writes reports to `dist/TOKEN_TALLY.md` and -`dist/TOKEN_TALLY.json`. It tracks `.agents/rules/*.md`, -`.agents/commands/*.md`, `.agents/skills/*/SKILL.md`, and -`.agents/skills/*/agents/*.md`. YAML front matter metadata is excluded from +`dist/TOKEN_TALLY.json`. It tracks `src/rules/*.md`, +`src/commands/*.md`, `src/skills/*/SKILL.md`, and +`src/skills/*/agents/*.md`. YAML front matter metadata is excluded from token counts for every tracked Markdown file; files without front matter are counted in full. diff --git a/.devops/js-tools/scripts/comment-library-token-diff.mjs b/.devops/js-tools/scripts/comment-library-token-diff.mjs index bb9f560..cfa261d 100644 --- a/.devops/js-tools/scripts/comment-library-token-diff.mjs +++ b/.devops/js-tools/scripts/comment-library-token-diff.mjs @@ -48,7 +48,7 @@ async function changedLibraryFiles() { "--find-renames", `${baseRef}...${headRef}`, "--", - ".agents/", + "src/", ]); const rows = []; @@ -57,8 +57,8 @@ async function changedLibraryFiles() { const status = fields[0]; const basePath = status.startsWith("R") ? fields[1] : fields[1] ?? fields[0]; const headPath = status.startsWith("R") ? fields[2] : fields[1] ?? fields[0]; - const baseInLibrary = basePath?.startsWith(".agents/"); - const headInLibrary = headPath?.startsWith(".agents/"); + const baseInLibrary = basePath?.startsWith("src/"); + const headInLibrary = headPath?.startsWith("src/"); const displayPath = headInLibrary ? headPath : basePath; if (!baseInLibrary && !headInLibrary) continue; @@ -81,7 +81,7 @@ async function changedLibraryFiles() { } function isEvalPath(path) { - return path?.startsWith(".agents/") && path.split("/").includes("evals"); + return path?.startsWith("src/") && path.split("/").includes("evals"); } function statusLabel(status) { @@ -131,7 +131,7 @@ function renderComment(rows) { const marker = ""; if (rows.length === 0) { return `${marker} -No \`.agents/\` file token changes detected. +No \`src/\` file token changes detected. `; } @@ -148,7 +148,7 @@ No \`.agents/\` file token changes detected. return `${marker} ## Library Token Diff -Estimated token changes for files under \`.agents/\`. +Estimated token changes for files under \`src/\`. | File | Status | Before | After | Delta | | --- | --- | ---: | ---: | ---: | diff --git a/.devops/js-tools/scripts/count-tokens.mjs b/.devops/js-tools/scripts/count-tokens.mjs index 35067cc..7ed40e4 100644 --- a/.devops/js-tools/scripts/count-tokens.mjs +++ b/.devops/js-tools/scripts/count-tokens.mjs @@ -80,8 +80,8 @@ async function buildTokenReport() { async function trackedFiles() { return [ - ...(await markdownEntries("command", ".agents/commands")), - ...(await markdownEntries("rule", ".agents/rules")), + ...(await markdownEntries("command", "src/commands")), + ...(await markdownEntries("rule", "src/rules")), ...(await skillEntries()), ...(await agentEntries()), ]; @@ -103,13 +103,13 @@ async function markdownEntries(kind, directory) { } async function skillEntries() { - const skillsDirectory = join(repoRoot, ".agents/skills"); + const skillsDirectory = join(repoRoot, "src/skills"); const skills = await readdir(skillsDirectory, { withFileTypes: true }); const entries = await Promise.all( skills.filter((skill) => skill.isDirectory()).map(async (skill) => ({ kind: "skill", name: skill.name, - path: `.agents/skills/${skill.name}/SKILL.md`, + path: `src/skills/${skill.name}/SKILL.md`, exists: await fileExists(join(skillsDirectory, skill.name, "SKILL.md")), })), ); @@ -120,7 +120,7 @@ async function skillEntries() { async function agentEntries() { const agents = []; - const skillsDirectory = join(repoRoot, ".agents/skills"); + const skillsDirectory = join(repoRoot, "src/skills"); const skills = await readdir(skillsDirectory, { withFileTypes: true }); for (const skill of skills.filter((entry) => entry.isDirectory())) { @@ -137,7 +137,7 @@ async function agentEntries() { agents.push({ kind: "agent", name: `${skill.name}/${name}`, - path: `.agents/skills/${skill.name}/agents/${file.name}`, + path: `src/skills/${skill.name}/agents/${file.name}`, }); } } diff --git a/.github/workflows/labels.yml b/.github/workflows/labels.yml index 440bc8d..bbab0b4 100644 --- a/.github/workflows/labels.yml +++ b/.github/workflows/labels.yml @@ -34,10 +34,10 @@ jobs: {"name": "stale", "color": "848d97", "description": "No activity, may auto-close"}, {"name": "declined", "color": "e6e6e6", "description": "Will not be implemented"}, {"name": "playbook", "color": "0075ca", "description": "Core AGENTS.md playbook model and compatibility guidance"}, - {"name": "rules", "color": "d4c5f9", "description": "Reusable rule files under .agents/rules"}, + {"name": "rules", "color": "d4c5f9", "description": "Reusable rule files under src/rules"}, {"name": "skills", "color": "a2eeef", "description": "Reusable skill specs and skill authoring guidance"}, - {"name": "commands", "color": "bfd4f2", "description": "Slash command definitions under .agents/commands"}, - {"name": "memory", "color": "c2e0c6", "description": "Agent memory conventions and .agents/memory content"}, + {"name": "commands", "color": "bfd4f2", "description": "Slash command definitions under src/commands"}, + {"name": "memory", "color": "c2e0c6", "description": "Agent memory conventions and src/memory content"}, {"name": "documentation", "color": "bfdadc", "description": "Task-scoped docs, PRDs, specs, and implementation notes"}, {"name": "site", "color": "fef2c0", "description": "GitHub Pages content, config, and assets"}, {"name": "automation", "color": "fbca04", "description": "GitHub Actions, hooks, and repository automation"}, diff --git a/.github/workflows/library-token-diff.yml b/.github/workflows/library-token-diff.yml index 69038bd..62b8a3d 100644 --- a/.github/workflows/library-token-diff.yml +++ b/.github/workflows/library-token-diff.yml @@ -8,7 +8,7 @@ on: - reopened - ready_for_review paths: - - ".agents/**" + - "src/**" permissions: contents: read diff --git a/.gitignore b/.gitignore index 33504fe..e323e2f 100644 --- a/.gitignore +++ b/.gitignore @@ -496,6 +496,6 @@ $RECYCLE.BIN/ # End of https://www.toptal.com/developers/gitignore/api/linux,macos,dotenv,python,windows,intellij+all,visualstudiocode,node # Evaluation output quality files -.agents/**/evals/* -!.agents/**/evals/evals.json -!.agents/**/evals/evals.yaml +src/**/evals/* +!src/**/evals/evals.json +!src/**/evals/evals.yaml diff --git a/AGENTS.md b/AGENTS.md index a8619f0..764e9c0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -38,7 +38,7 @@ docs/ # Project-scoped documentation - Folder names: lowercase, hyphenated — e.g. `user-auth`, `payment-v2`, `issue-142` - Create a docs task folder only when the work needs durable task-scoped documentation such as `PRD.md`, `SPEC.md`, `ARCHITECTURE.md`, or `DESIGN.md` -- Small task checklists and completed implementation notes belong in `.agents/memory/YYYY-MM-DD.md` +- Small task checklists and completed implementation notes belong in `src/memory/YYYY-MM-DD.md` ## Loaded Context @@ -46,15 +46,15 @@ docs/ # Project-scoped documentation | File | Purpose | Auto-load | | --- | --- | --- | -| .agents/memory/MEMORY.md | Durable project facts and decisions | yes | -| .agents/memory/YYYY-MM-DD.md | Daily task notes and observations | on-demand | +| src/memory/MEMORY.md | Durable project facts and decisions | yes | +| src/memory/YYYY-MM-DD.md | Daily task notes and observations | on-demand | ## Working on a task **Match the tracking weight to the work.** - For substantial work, create a task folder before writing code: `mkdir docs/$(date +%Y-%m-%d)-my-feature` -- For small work, track the checklist in `.agents/memory/$(date -u +%Y-%m-%d).md` +- For small work, track the checklist in `src/memory/$(date -u +%Y-%m-%d).md` - Use `TASKS.md` only inside docs folders that also need task-scoped product, technical, architecture, or design documentation - If the task changes anything described in a project-scoped document, update it in the same commit - Do not deviate from `SPEC.md` silently — update the file if the spec changes diff --git a/README.md b/README.md index 306a42c..2d0922b 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ > A portable, tool-agnostic file structure playbook for LLM agents in software projects. -Agent behavior is code. It should be versioned, reviewed, modular, and readable by both humans and machines. The `.agents/` folder is the single source of truth for everything an LLM agent needs to operate within a project — permissions, instructions, skills, memory, commands, and documentation artifacts. +Agent behavior is code. It should be versioned, reviewed, modular, and readable by both humans and machines. The `src/` folder is the single source of truth for everything an LLM agent needs to operate within a project — permissions, instructions, skills, memory, commands, and documentation artifacts. ## Overview @@ -16,11 +16,11 @@ This playbook gives agents — and the humans working alongside them — a consi ## Features - **`AGENTS.md`** — Primary instruction file and manifest. Every runtime loads this first. -- **`.agents/rules/`** — Modular, composable instruction files. -- **`.agents/skills/`** — Auto-invoking workflows triggered by events or file patterns. -- **`.agents/commands/`** — Explicit slash commands. -- **`.agents/agents/`** — Subagent personas invoked by `@mention`. -- **`.agents/memory/`** — Persistent, append-only memory across sessions. +- **`src/rules/`** — Modular, composable instruction files. +- **`src/skills/`** — Auto-invoking workflows triggered by events or file patterns. +- **`src/commands/`** — Explicit slash commands. +- **`src/agents/`** — Subagent personas invoked by `@mention`. +- **`src/memory/`** — Persistent, append-only memory across sessions. - **`docs/`** — Task-scoped documentation with standardized layout (PRD, SPEC, ARCHITECTURE, TASKS). ## Core Principles @@ -35,7 +35,7 @@ This playbook gives agents — and the humans working alongside them — a consi ```text agent.md/ # ← this repository -├── .agents/ # Maintained agent asset library +├── src/ # Maintained agent asset library ├── docs/ # Task-scoped documentation ├── pages/ # GitHub Pages source │ ├── _config.yml # GitHub Pages configuration @@ -73,13 +73,13 @@ Add `skills/`, `commands/`, `agents/`, and `docs/` as the project matures. ### Library -This repository maintains its primary reusable agent assets in [`.agents/`](./.agents): +This repository maintains its primary reusable agent assets in [`src/`](./.agents): -- **Rules** — `.agents/rules/formatting-markdown.md` -- **Skills** — `.agents/skills/on-new-example/SKILL.md` -- **Commands** — `.agents/commands/validate.md` -- **Agents** — `.agents/agents/spec-reviewer.md` -- **Memory** — `.agents/memory/MEMORY.md` +- **Rules** — `src/rules/formatting-markdown.md` +- **Skills** — `src/skills/on-new-example/SKILL.md` +- **Commands** — `src/commands/validate.md` +- **Agents** — `src/agents/spec-reviewer.md` +- **Memory** — `src/memory/MEMORY.md` ### Real project layout @@ -121,7 +121,7 @@ project-root/ ## Development -This repo uses itself to govern its own development — the `.agents/` folder is the maintained set of playbook-conformant assets used for that work. +This repo uses itself to govern its own development — the `src/` folder is the maintained set of playbook-conformant assets used for that work. ```bash # No build step required. All content is plain Markdown. diff --git a/docs/2026-05-02-team-roles-as-skills/PRD.md b/docs/2026-05-02-team-roles-as-skills/PRD.md index 0e39c02..9b53a21 100644 --- a/docs/2026-05-02-team-roles-as-skills/PRD.md +++ b/docs/2026-05-02-team-roles-as-skills/PRD.md @@ -36,7 +36,7 @@ The initiative targets teams and individual practitioners who want role-aware AI | Goal ID | Target Outcome | Success Metric | | --- | --- | --- | | G-1 | Cover the core artifact-producing responsibilities of a software delivery team. | 55 cataloged skills exist across the approved verb groups. | -| G-1a | Track current implementation progress against the catalog. | 10 of 55 catalog skills currently exist in `.agents/skills/`; current catalog completion is 18%. | +| G-1a | Track current implementation progress against the catalog. | 10 of 55 catalog skills currently exist in `src/skills/`; current catalog completion is 18%. | | G-2 | Make skill discovery predictable from the filesystem. | 100% of catalog skills follow the `-[-]` naming convention. | | G-3 | Reduce repeated role-specific prompting. | Users can invoke each completed skill by artifact or task intent without restating its output structure or role conventions. | | G-4 | Produce concrete, reusable artifacts instead of generic advice. | Every completed skill description names the artifact it produces and when it should trigger. | @@ -87,12 +87,12 @@ The initiative targets teams and individual practitioners who want role-aware AI | Requirement ID | Capability / Feature | Priority | Acceptance Criteria | Tracker | | --- | --- | --- | --- | --- | -| FR-1 | Define and track the full team-role skill catalog. | MUST | Catalog includes 55 named skills; each skill maps to at least one primary role and one output artifact; implementation status is checked against `.agents/skills/`; catalog stays aligned across PRD, SPEC, and TASKS. | [TASKS.md](TASKS.md) | +| FR-1 | Define and track the full team-role skill catalog. | MUST | Catalog includes 55 named skills; each skill maps to at least one primary role and one output artifact; implementation status is checked against `src/skills/`; catalog stays aligned across PRD, SPEC, and TASKS. | [TASKS.md](TASKS.md) | | FR-2 | Enforce verb-first skill naming. | MUST | Every skill name follows `-[-]`; verbs match the approved verb list in SPEC.md; renames are reflected in docs and task tracking. | [SPEC.md](SPEC.md) | | FR-3 | Provide a standard skill structure. | MUST | Each skill has a `SKILL.md` with valid frontmatter; each skill has eval coverage; large reusable guidance lives in `references/` instead of bloating `SKILL.md`. | [SPEC.md](SPEC.md) | | FR-4 | Support multi-variant routing where domains share one role context. | SHOULD | Router skills detect variants from prompt and repo context; router skills ask at most one clarifying question when context is materially ambiguous; variant references are loaded on demand. | [SPEC.md](SPEC.md) | | FR-5 | Prioritize build order by daily leverage and role coverage. | MUST | P1 foundation skills are built first; P2/P3/P4 priorities are visible in TASKS.md; completed skills are marked in the tracker. | [TASKS.md](TASKS.md) | -| FR-6 | Package completed skills for distribution. | SHOULD | Completed skills can be exported as `.skill` files; package contents include instructions, references, scripts, and assets needed for reuse; root-level evals are retained in the source folder and excluded from packaged artifacts by the current packager. | [SPEC.md](SPEC.md), [.agents/skills/README.md](../../.agents/skills/README.md) | +| FR-6 | Package completed skills for distribution. | SHOULD | Completed skills can be exported as `.skill` files; package contents include instructions, references, scripts, and assets needed for reuse; root-level evals are retained in the source folder and excluded from packaged artifacts by the current packager. | [SPEC.md](SPEC.md), [src/skills/README.md](../../src/skills/README.md) | | FR-7 | Keep security and test responsibilities separated. | MUST | `audit-security` owns prompt-injection, jailbreak, exfiltration, secrets, and threat-modeling guidance; `code-tests` owns functional tests, AI evals, tool-use evals, performance tests, and CI test setup. | [SPEC.md](SPEC.md) | --- @@ -165,7 +165,7 @@ For multi-variant skills, the expected interaction is context-first routing. For | --- | --- | --- | --- | --- | | DEC-1 | Use milestone gates instead of a fixed calendar date for the first complete catalog release. | The release is ready when all 55 cataloged skills are implemented, evaluated, documented, and packageable; 10 catalog skills are implemented as of 2026-05-23. | Oleg Shulyakov [assumed] | 2026-05-23 | | DEC-2 | Use the `create-skill` eval bar: 8-10 realistic eval prompts for focused skills and 8-10 prompts per routed reference for router skills. | This keeps the PRD aligned with the maintained authoring workflow while allowing specialized skills to add cases for variant coverage, boundary-trigger testing, or safety-sensitive behavior. | Skill maintainers [assumed] | 2026-05-23 | -| DEC-3 | Package release-ready skills from `.agents/skills/create-skill` with `python3 -m scripts.package_skill ../ /tmp/skills-dist`. | Release readiness requires `validate.py` to pass, evals to be present in source and pass at least an 85% aggregate expectation pass rate with no failed critical expectations, router evals to include `reference` fields, references to be useful, and no security or packaging blockers to remain. | Skill maintainers [assumed] | 2026-05-23 | +| DEC-3 | Package release-ready skills from `src/skills/create-skill` with `python3 -m scripts.package_skill ../ /tmp/skills-dist`. | Release readiness requires `validate.py` to pass, evals to be present in source and pass at least an 85% aggregate expectation pass rate with no failed critical expectations, router evals to include `reference` fields, references to be useful, and no security or packaging blockers to remain. | Skill maintainers [assumed] | 2026-05-23 | | DEC-4 | Treat organization-level convention packs as a separate follow-up. | This initiative ships the base local skill library first; organization convention packs should layer on later once the base format and release checks are stable. | Oleg Shulyakov [assumed] | 2026-05-23 | --- @@ -174,4 +174,4 @@ For multi-variant skills, the expected interaction is context-first routing. For - **Ref-1**: Technical specification - [SPEC.md](SPEC.md) - **Ref-2**: Build tracker - [TASKS.md](TASKS.md) -- **Ref-3**: Daily memory note for prior catalog updates - [.agents/memory/2026-05-18.md](../../.agents/memory/2026-05-18.md) +- **Ref-3**: Daily memory note for prior catalog updates - [src/memory/2026-05-18.md](../../src/memory/2026-05-18.md) diff --git a/docs/2026-05-02-team-roles-as-skills/SPEC.md b/docs/2026-05-02-team-roles-as-skills/SPEC.md index 65d95c4..7ce1c76 100644 --- a/docs/2026-05-02-team-roles-as-skills/SPEC.md +++ b/docs/2026-05-02-team-roles-as-skills/SPEC.md @@ -57,7 +57,7 @@ The library must remain local-first. It is not a plugin marketplace, a project m | Goal | Success Metric | Target | | --- | --- | --- | -| Complete catalog coverage | Cataloged software delivery role skills exist in `.agents/skills/`. | 55 skills | +| Complete catalog coverage | Cataloged software delivery role skills exist in `src/skills/`. | 55 skills | | Keep discovery predictable | Skill names follow verb-first convention. | 100% compliance | | Reduce repeated prompting | Completed skills encode trigger, output, and quality expectations. | Every completed skill has specific frontmatter and instructions | | Keep complex domains usable | Router skills select variants from context. | Ask at most one clarifying question when materially ambiguous | @@ -118,7 +118,7 @@ Runtime plugin hosting, remote skill fetching, marketplace behavior, live Jira/G - The catalog lists each skill name, primary roles, and output artifact. - Each catalog skill maps to one approved verb. - PRD, SPEC, and TASKS agree on catalog names. -- Drift between docs and `.agents/skills/` is treated as a release blocker. +- Drift between docs and `src/skills/` is treated as a release blocker. #### FR-002: Verb-First Naming @@ -179,7 +179,7 @@ Runtime plugin hosting, remote skill fetching, marketplace behavior, live Jira/G **Acceptance criteria:** -- `python3 .agents/skills/create-skill/scripts/validate.py .agents/skills/` passes. +- `python3 src/skills/create-skill/scripts/validate.py src/skills/` passes. - Focused skills have 8-10 realistic eval prompts. - Router skills have 8-10 eval prompts per routed reference before release readiness. - Eval assertions reach at least 85% aggregate pass rate with no failed critical expectations. @@ -193,7 +193,7 @@ Runtime plugin hosting, remote skill fetching, marketplace behavior, live Jira/G **Acceptance criteria:** -- Packaging runs from `.agents/skills/create-skill`. +- Packaging runs from `src/skills/create-skill`. - Package command succeeds: `python3 -m scripts.package_skill ../ /tmp/skills-dist`. - Package includes required instructions, references, scripts, and assets. - Root-level `evals/` are intentionally excluded from packaged artifacts by `package_skill.py`. @@ -238,7 +238,7 @@ The verb identifies the artifact or action family. The subject identifies the do ### 4.2 Filesystem Layout ```text -.agents/skills/ +src/skills/ ├── / │ ├── SKILL.md │ ├── evals/ @@ -398,7 +398,7 @@ Router skills for this release are `audit-security`, `code-frontend`, `code-back Each release-ready skill must pass: ```bash -python3 .agents/skills/create-skill/scripts/validate.py .agents/skills/ +python3 src/skills/create-skill/scripts/validate.py src/skills/ ``` Validation failures block packaging. Common blockers include invalid frontmatter, missing required sections, weak scan anchors, malformed evals, missing router `reference` fields, and unused placeholder folders. @@ -445,7 +445,7 @@ Each skill should be built with `create-skill` using this sequence: 7. Review outputs qualitatively and assertions quantitatively where objective checks apply. 8. Iterate until feedback is resolved, improvements flatten, or the user accepts behavior. 9. Tune the description for triggering accuracy after behavior is stable. -10. Package release-ready skills from `.agents/skills/create-skill`: +10. Package release-ready skills from `src/skills/create-skill`: ```bash python3 -m scripts.package_skill ../ /tmp/skills-dist @@ -485,7 +485,7 @@ python3 -m scripts.package_skill ../ /tmp/skills-dist | Team conventions do not fit base skills. | Medium | Keep base skills generic; defer convention packs. | Open | | Docs drift from folders. | High | Update PRD, SPEC, TASKS, and memory together. | Open | | Older skills fail current validation. | High | Run validation per skill and fix blockers before release readiness. | Open | -| Implementation count is inconsistent. | Medium | Reconcile PRD status, TASKS, and actual `.agents/skills/` folders. | Open | +| Implementation count is inconsistent. | Medium | Reconcile PRD status, TASKS, and actual `src/skills/` folders. | Open | ## 12. Decisions @@ -509,8 +509,8 @@ python3 -m scripts.package_skill ../ /tmp/skills-dist - Product requirements: [PRD.md](PRD.md) - Build tracker: [TASKS.md](TASKS.md) -- Prior memory note: [.agents/memory/2026-05-18.md](../../.agents/memory/2026-05-18.md) -- Skill authoring support: [create-skill](../../.agents/skills/create-skill/SKILL.md) +- Prior memory note: [src/memory/2026-05-18.md](../../src/memory/2026-05-18.md) +- Skill authoring support: [create-skill](../../src/skills/create-skill/SKILL.md) ### 14.2 Totals diff --git a/docs/2026-05-20-general-agent-skills/PRD.md b/docs/2026-05-20-general-agent-skills/PRD.md index 9a3147b..6bd97c7 100644 --- a/docs/2026-05-20-general-agent-skills/PRD.md +++ b/docs/2026-05-20-general-agent-skills/PRD.md @@ -57,7 +57,7 @@ Without these skills, the agent has to infer these broad behaviors from generic - `investigate`: Investigate local code, project docs, attached artifacts, and repository context when local research is needed. - `choose`: Compare options and recommend a course of action with tradeoffs, assumptions, and decision criteria. - `manage`: Manage multi-step or multi-agent work by tracking goals, owners, dependencies, status, blockers, handoffs, and next actions. -- `remember`: Capture durable project facts, decisions, and useful observations in `.agents/memory/`. +- `remember`: Capture durable project facts, decisions, and useful observations in `src/memory/`. - `adapt`: Detect when existing behavior, skills, rules, workflows, docs, evals, or memory conventions no longer fit observed outcomes, user feedback, failures, repeated friction, outdated assumptions, or changed constraints, then identify what should change and which appropriate skill or workflow should make the change. - Trigger and exclusion guidance for each skill. - Acceptance criteria and eval prompts for skill behavior. @@ -90,7 +90,7 @@ Without these skills, the agent has to infer these broad behaviors from generic | FR-6 | Define `investigate` as the skill for local investigation and repository research. | MUST | Triggers on “investigate”, “investigate”, “find where”, “understand this repo”, “trace”, and local-context research requests. Covers local code, project docs, attached artifacts, and repository context only. Produces findings with file references, artifact references, or uncertainty clearly marked. | TBD | | FR-7 | Define `choose` as the skill for choosing among options. | MUST | Triggers on “choose”, “choose”, “which option”, “tradeoffs”, “recommend”, and “should we”. States decision criteria, compares viable options, recommends one, and identifies reversibility or risk. | TBD | | FR-8 | Define `manage` as the skill for managing active work across people, agents, tasks, and dependencies. | MUST | Triggers on “manage”, “manage this work”, “team lead”, “lead this”, “assign”, “delegate”, “track blockers”, “status”, “handoff”, and multi-agent or multi-workstream requests. Maintains an execution view with goals, owners, dependencies, current status, blockers, and next actions. | TBD | -| FR-9 | Define `remember` as the skill for durable project memory. | MUST | Triggers when the user asks to remember, save context, record a decision, update memory, or preserve a project fact. When the user explicitly asks to remember something, the memory write is auto-approved and should proceed without asking again. Writes only durable facts, decisions, and observations to `.agents/memory/` according to project conventions. Avoids storing transient task chatter or unverifiable assumptions as fact. | TBD | +| FR-9 | Define `remember` as the skill for durable project memory. | MUST | Triggers when the user asks to remember, save context, record a decision, update memory, or preserve a project fact. When the user explicitly asks to remember something, the memory write is auto-approved and should proceed without asking again. Writes only durable facts, decisions, and observations to `src/memory/` according to project conventions. Avoids storing transient task chatter or unverifiable assumptions as fact. | TBD | | FR-10 | Define `adapt` as the skill for detecting evidence-driven change needs and routing the update. | MUST | Triggers on “adapt based on this”, “what should change after this?”, “fold this feedback into our process”, “this keeps happening”, “we keep hitting this issue”, “this failed, what should change?”, “our instructions didn’t handle this”, “the workflow no longer fits”, “the constraints changed”, “this behavior is outdated”, “adjust future behavior based on this”, “turn this failure into an instruction change”, “what artifact should change because of this?”, and “do we need to update a skill, rule, doc, eval, or memory?”. Identifies the adaptation signal, affected behavior or artifact, smallest useful change, and appropriate follow-up skill or workflow. Does not directly update artifacts by default. | TBD | | FR-11 | Document standalone runtime boundaries. | MUST | Each skill defines its own purpose, trigger phrases, non-trigger cases, expected behavior, and output shape without requiring, calling, importing, or delegating to another skill at runtime. `adapt` may identify an appropriate follow-up skill or workflow as a route, but that route is not a runtime dependency. | TBD | | FR-12 | Add behavior evals. | SHOULD | Each skill has at least 7 representative prompts: 3 true-positive prompts, 2 false-positive prompts, and 2 non-trigger prompts. | TBD | @@ -102,7 +102,7 @@ Without these skills, the agent has to infer these broad behaviors from generic | NFR ID | Category | Target Specification | | --- | --- | --- | | NFR-1 | Maintainability | Each skill has one clear workflow and avoids becoming a dumping ground for generic agent behavior. | -| NFR-2 | Portability | Skills work across repositories and do not assume this repository layout except where `remember` explicitly uses `.agents/memory/`. Runtime behavior must not depend on any other skill being installed. | +| NFR-2 | Portability | Skills work across repositories and do not assume this repository layout except where `remember` explicitly uses `src/memory/`. Runtime behavior must not depend on any other skill being installed. | | NFR-3 | Token Efficiency | Main `SKILL.md` files stay concise; long examples or eval details move to references only when they reduce ambiguity. | | NFR-4 | Question Quality | `ask` must prefer the fewest high-leverage questions over exhaustive questionnaires. | | NFR-5 | Reasoning Quality | `brainstorm` must expose assumptions, uncertainty, and competing interpretations instead of presenting guesses as settled conclusions. | @@ -161,7 +161,7 @@ Without these skills, the agent has to infer these broad behaviors from generic | Dependency ID | Item | Impacted Requirements | Validation Owner | | --- | --- | --- | --- | -| D-1 | Existing `.agents/memory/` conventions | FR-9, NFR-8 | Oleg Shulyakov | +| D-1 | Existing `src/memory/` conventions | FR-9, NFR-8 | Oleg Shulyakov | | D-2 | `create-skill` validation workflow for development-time checks only | FR-12 | TBD | --- diff --git a/docs/2026-05-20-general-agent-skills/SPEC.md b/docs/2026-05-20-general-agent-skills/SPEC.md index 5a11e5f..fc9bc47 100644 --- a/docs/2026-05-20-general-agent-skills/SPEC.md +++ b/docs/2026-05-20-general-agent-skills/SPEC.md @@ -74,12 +74,12 @@ This work does not add live integrations with Jira, Linear, Confluence, GitHub I ### 2.2 Skill File Layout -Each skill shall live in its own folder under `.agents/skills//`. +Each skill shall live in its own folder under `src/skills//`. Each skill folder shall include: ```text -.agents/skills// +src/skills// ├── SKILL.md └── evals/ └── evals.yaml @@ -216,7 +216,7 @@ Each skill body shall define purpose, scope, trigger cases, non-trigger cases, w #### FR-009: `remember` **Priority:** Must-have -**Description:** The system shall use `remember` to preserve durable project facts, decisions, and useful observations in `.agents/memory/`. +**Description:** The system shall use `remember` to preserve durable project facts, decisions, and useful observations in `src/memory/`. **Acceptance criteria:** @@ -224,7 +224,7 @@ Each skill body shall define purpose, scope, trigger cases, non-trigger cases, w - [ ] Treats explicit user requests to remember context as approval to write memory without asking again. - [ ] Writes only durable facts, decisions, and observations with project value. - [ ] Avoids storing transient task chatter, sensitive information, or unverifiable assumptions as fact. -- [ ] Follows existing `.agents/memory/MEMORY.md` and dated memory file conventions. +- [ ] Follows existing `src/memory/MEMORY.md` and dated memory file conventions. #### FR-010: `adapt` @@ -259,7 +259,7 @@ Each skill body shall define purpose, scope, trigger cases, non-trigger cases, w **Acceptance criteria:** -- [ ] Each skill has `evals/evals.yaml` generated through `.agents/skills/create-skill/`. +- [ ] Each skill has `evals/evals.yaml` generated through `src/skills/create-skill/`. - [ ] Each skill has 8-10 realistic eval prompts where possible, and never fewer than the PRD minimum of 7. - [ ] Each eval set includes at least 3 true-positive prompts. - [ ] Each eval set includes at least 2 false-positive prompts where nearby language should route elsewhere or not trigger. @@ -278,7 +278,7 @@ Each skill body shall define purpose, scope, trigger cases, non-trigger cases, w **BR-005:** `adapt` detects and routes evidence-driven change needs. It shall not directly rewrite skills, rules, docs, evals, or memory by default. -**BR-006:** Durable task documentation belongs under `docs/`; durable memory facts and small implementation notes belong under `.agents/memory/`. +**BR-006:** Durable task documentation belongs under `docs/`; durable memory facts and small implementation notes belong under `src/memory/`. --- @@ -317,11 +317,11 @@ flowchart TD | Component | Responsibility | | --- | --- | -| `.agents/skills//SKILL.md` | Runtime instructions, metadata, trigger guidance, exclusions, workflow, and output expectations | -| `.agents/skills//evals/evals.yaml` | Representative trigger and non-trigger prompts generated through `create-skill` | -| `.agents/skills//evals/iterations/iteration-N/` | Reproducible eval run outputs, grading, and benchmark artifacts when generated | -| `.agents/memory/` | Target memory location for `remember` behavior | -| `.agents/skills/create-skill/` | Development-time eval generation, validation, and packaging support | +| `src/skills//SKILL.md` | Runtime instructions, metadata, trigger guidance, exclusions, workflow, and output expectations | +| `src/skills//evals/evals.yaml` | Representative trigger and non-trigger prompts generated through `create-skill` | +| `src/skills//evals/iterations/iteration-N/` | Reproducible eval run outputs, grading, and benchmark artifacts when generated | +| `src/memory/` | Target memory location for `remember` behavior | +| `src/skills/create-skill/` | Development-time eval generation, validation, and packaging support | ### 4.3 Key Design Decisions @@ -343,7 +343,7 @@ Per-skill eval files keep each installable unit self-contained. A shared overlap No database or structured runtime data model is added. -The only persistent output introduced by skill behavior is `remember` writing Markdown entries under `.agents/memory/` according to existing conventions. +The only persistent output introduced by skill behavior is `remember` writing Markdown entries under `src/memory/` according to existing conventions. Memory entries shall use one of these categories when applicable: facts, preferences, decisions, or observations. Decision entries should include context, decision, and revisit conditions when those details are available. @@ -381,7 +381,7 @@ Review every `SKILL.md` for frontmatter completeness, trigger specificity, exclu ### 8.2 Trigger Eval Review -For each skill, generate and review `evals/evals.yaml` through `.agents/skills/create-skill/`. Use 8-10 realistic prompts where possible, and never fewer than the PRD minimum of 7: +For each skill, generate and review `evals/evals.yaml` through `src/skills/create-skill/`. Use 8-10 realistic prompts where possible, and never fewer than the PRD minimum of 7: ```text 3 true-positive prompts @@ -422,7 +422,7 @@ Manual acceptance passes when a reviewer can invoke representative prompts and o ### Phase 2: Evals -- [ ] Generate evals through `.agents/skills/create-skill/`. +- [ ] Generate evals through `src/skills/create-skill/`. - [ ] Add generated evals for each skill. - [ ] Include true-positive, false-positive, and non-trigger prompts. - [ ] Add boundary prompts for common overlaps. @@ -436,7 +436,7 @@ Manual acceptance passes when a reviewer can invoke representative prompts and o ### Phase 4: Release Readiness -- [ ] Update `.agents/skills/README.md` if it indexes maintained skills. +- [ ] Update `src/skills/README.md` if it indexes maintained skills. - [ ] Update project memory or docs only when durable decisions change. - [ ] Prepare reviewer handoff with changed files and validation results. @@ -445,8 +445,8 @@ Manual acceptance passes when a reviewer can invoke representative prompts and o | Dependency | Needed By | | --- | --- | | Existing skill authoring conventions | All skill files | -| Existing `.agents/memory/` conventions | `remember` | -| `.agents/skills/create-skill/` eval generation workflow | Evals and release readiness | +| Existing `src/memory/` conventions | `remember` | +| `src/skills/create-skill/` eval generation workflow | Evals and release readiness | --- @@ -467,7 +467,7 @@ Manual acceptance passes when a reviewer can invoke representative prompts and o | # | Question | Owner | Due | Status | | --- | --- | --- | --- | --- | -| 1 | Should eval prompts be plain Markdown or a machine-readable format? | Oleg Shulyakov | 2026-05-21 | Resolved: evals are generated by `.agents/skills/create-skill/`. | +| 1 | Should eval prompts be plain Markdown or a machine-readable format? | Oleg Shulyakov | 2026-05-21 | Resolved: evals are generated by `src/skills/create-skill/`. | | 2 | Should `explain` be treated as already complete or revised to match the new general skill set style? | Oleg Shulyakov | 2026-05-21 | Resolved: mark `explain` as complete. | | 3 | Should every new skill use version `1.0.0`, or inherit a project-wide initial version convention? | Oleg Shulyakov | 2026-05-21 | Resolved: use `1.0.0` as the initial version. | | 4 | Should the evidence-driven change-detection skill be named `evolve` or `adapt`? | Oleg Shulyakov | 2026-05-24 | Resolved: use `adapt`, because it detects that existing behavior no longer fits evidence without implying autonomous self-modification. | @@ -480,6 +480,6 @@ Manual acceptance passes when a reviewer can invoke representative prompts and o Related documents: - [PRD.md](PRD.md) -- `.agents/memory/MEMORY.md` -- `.agents/skills/create-skill/SKILL.md` -- `.agents/skills/explain/SKILL.md` +- `src/memory/MEMORY.md` +- `src/skills/create-skill/SKILL.md` +- `src/skills/explain/SKILL.md` diff --git a/docs/2026-05-20-general-agent-skills/user-stories/US-001-author-standalone-general-skills.md b/docs/2026-05-20-general-agent-skills/user-stories/US-001-author-standalone-general-skills.md index 0b56d51..bf1a26e 100644 --- a/docs/2026-05-20-general-agent-skills/user-stories/US-001-author-standalone-general-skills.md +++ b/docs/2026-05-20-general-agent-skills/user-stories/US-001-author-standalone-general-skills.md @@ -21,7 +21,7 @@ Source documents: ## 🔍 2. Strict Constraints & Scope Boundaries - **In-Scope:** - - Create `.agents/skills//SKILL.md` for `ask`, `brainstorm`, `classify`, `plan`, `investigate`, `choose`, `manage`, `remember`, and `adapt`. + - Create `src/skills//SKILL.md` for `ask`, `brainstorm`, `classify`, `plan`, `investigate`, `choose`, `manage`, `remember`, and `adapt`. - Use initial skill version `1.0.0`. - Include frontmatter fields required by local skill conventions. - Define each skill's purpose, trigger cases, non-trigger cases, workflow, output expectations, error paths, and verification guidance where relevant. @@ -35,7 +35,7 @@ Source documents: - Skill folder shape: ```text -.agents/skills// +src/skills// ├── SKILL.md └── evals/ └── evals.yaml @@ -51,7 +51,7 @@ Source documents: Scenario: Create standalone skill instructions Given the approved SPEC defines nine new general skills When the agent creates the new skill folders and SKILL.md files - Then each new skill folder exists under .agents/skills/ + Then each new skill folder exists under src/skills/ And each SKILL.md includes name, description, license, version, tags, author, and metadata frontmatter And each new skill uses version 1.0.0 @@ -74,19 +74,19 @@ Scenario: Avoid placeholder support folders *Note to Agent: You are restricted to modifying or analyzing the following components.* - **Primary Target Files:** - 1. `.agents/skills/ask/SKILL.md` -> New question-generation skill. - 2. `.agents/skills/brainstorm/SKILL.md` -> New ambiguous-problem reasoning skill. - 3. `.agents/skills/classify/SKILL.md` -> New classification and grouping skill. - 4. `.agents/skills/plan/SKILL.md` -> New planning skill. - 5. `.agents/skills/investigate/SKILL.md` -> New local investigation skill. - 6. `.agents/skills/choose/SKILL.md` -> New decision support skill. - 7. `.agents/skills/manage/SKILL.md` -> New coordination skill. - 8. `.agents/skills/remember/SKILL.md` -> New durable memory skill. - 9. `.agents/skills/adapt/SKILL.md` -> New evidence-driven adaptation diagnosis and routing skill. + 1. `src/skills/ask/SKILL.md` -> New question-generation skill. + 2. `src/skills/brainstorm/SKILL.md` -> New ambiguous-problem reasoning skill. + 3. `src/skills/classify/SKILL.md` -> New classification and grouping skill. + 4. `src/skills/plan/SKILL.md` -> New planning skill. + 5. `src/skills/investigate/SKILL.md` -> New local investigation skill. + 6. `src/skills/choose/SKILL.md` -> New decision support skill. + 7. `src/skills/manage/SKILL.md` -> New coordination skill. + 8. `src/skills/remember/SKILL.md` -> New durable memory skill. + 9. `src/skills/adapt/SKILL.md` -> New evidence-driven adaptation diagnosis and routing skill. - **Shared Dependencies/Imports:** - - Follow `.agents/skills/create-skill/references/authoring.md`. + - Follow `src/skills/create-skill/references/authoring.md`. - Use [SPEC.md](../SPEC.md) as the implementation contract. - - Treat `.agents/skills/explain/SKILL.md` as complete. + - Treat `src/skills/explain/SKILL.md` as complete. --- @@ -94,7 +94,7 @@ Scenario: Avoid placeholder support folders *Note to Agent: Execute these steps sequentially. Verify state after each step.* -1. **Analyze & Validate:** Read [SPEC.md](../SPEC.md), `.agents/skills/create-skill/SKILL.md`, and `.agents/skills/create-skill/references/authoring.md`. +1. **Analyze & Validate:** Read [SPEC.md](../SPEC.md), `src/skills/create-skill/SKILL.md`, and `src/skills/create-skill/references/authoring.md`. 2. **Create Skill Folders:** Create only the nine missing skill directories and required files. 3. **Author Skill Instructions:** Write focused `SKILL.md` files with explicit trigger and non-trigger behavior. 4. **Check Runtime Boundaries:** Search new skill files for runtime dependency language that points to another skill. @@ -108,5 +108,5 @@ Scenario: Avoid placeholder support folders - [ ] **Compilation:** Not applicable; Markdown authoring only. - [ ] **Test Coverage:** New skill files are ready for eval generation in US-002. -- [ ] **No Regression:** Existing `.agents/skills/explain/SKILL.md` remains unchanged unless a documented spec mismatch required a fix. +- [ ] **No Regression:** Existing `src/skills/explain/SKILL.md` remains unchanged unless a documented spec mismatch required a fix. - [ ] **Idempotency:** Re-running the work does not duplicate folders, sections, or placeholder resources. diff --git a/docs/2026-05-20-general-agent-skills/user-stories/US-002-generate-skill-evals.md b/docs/2026-05-20-general-agent-skills/user-stories/US-002-generate-skill-evals.md index 645f523..5e18056 100644 --- a/docs/2026-05-20-general-agent-skills/user-stories/US-002-generate-skill-evals.md +++ b/docs/2026-05-20-general-agent-skills/user-stories/US-002-generate-skill-evals.md @@ -14,14 +14,14 @@ Source documents: - **Persona:** As a skill library maintainer, - **Action:** I want representative evals generated for each general skill, - **Outcome:** so that trigger behavior and near-miss boundaries can be reviewed before release. -- **Epic Context:** Implements FR-012 from the approved SPEC. Evals are generated through `.agents/skills/create-skill/` and stored inside each skill folder. +- **Epic Context:** Implements FR-012 from the approved SPEC. Evals are generated through `src/skills/create-skill/` and stored inside each skill folder. --- ## 🔍 2. Strict Constraints & Scope Boundaries - **In-Scope:** - - Generate `.agents/skills//evals/evals.yaml` for each new skill. + - Generate `src/skills//evals/evals.yaml` for each new skill. - Include 8-10 realistic prompts where possible, never fewer than 7. - Include at least 3 true-positive prompts, 2 false-positive prompts, and 2 non-trigger prompts per skill. - Include expected trigger behavior and expected output behavior for each eval. @@ -31,9 +31,9 @@ Source documents: - Do not store evals in a shared docs folder. - Do not create eval iteration output folders unless eval runs are actually executed. - **Data Models & Schemas:** - - Use the eval schema expected by `.agents/skills/create-skill/`. - - Store eval cases at `.agents/skills//evals/evals.yaml`. - - Store run outputs only under `.agents/skills//evals/iterations/iteration-N/` if runs are performed. + - Use the eval schema expected by `src/skills/create-skill/`. + - Store eval cases at `src/skills//evals/evals.yaml`. + - Store run outputs only under `src/skills//evals/iterations/iteration-N/` if runs are performed. --- @@ -69,17 +69,17 @@ Scenario: Preserve eval folder discipline *Note to Agent: You are restricted to modifying or analyzing the following components.* - **Primary Target Files:** - 1. `.agents/skills/ask/evals/evals.yaml` -> Trigger and output evals. - 2. `.agents/skills/brainstorm/evals/evals.yaml` -> Trigger and output evals. - 3. `.agents/skills/classify/evals/evals.yaml` -> Trigger and output evals. - 4. `.agents/skills/plan/evals/evals.yaml` -> Trigger and output evals. - 5. `.agents/skills/investigate/evals/evals.yaml` -> Trigger and output evals. - 6. `.agents/skills/choose/evals/evals.yaml` -> Trigger and output evals. - 7. `.agents/skills/manage/evals/evals.yaml` -> Trigger and output evals. - 8. `.agents/skills/remember/evals/evals.yaml` -> Trigger and output evals. - 9. `.agents/skills/adapt/evals/evals.yaml` -> Trigger and output evals. + 1. `src/skills/ask/evals/evals.yaml` -> Trigger and output evals. + 2. `src/skills/brainstorm/evals/evals.yaml` -> Trigger and output evals. + 3. `src/skills/classify/evals/evals.yaml` -> Trigger and output evals. + 4. `src/skills/plan/evals/evals.yaml` -> Trigger and output evals. + 5. `src/skills/investigate/evals/evals.yaml` -> Trigger and output evals. + 6. `src/skills/choose/evals/evals.yaml` -> Trigger and output evals. + 7. `src/skills/manage/evals/evals.yaml` -> Trigger and output evals. + 8. `src/skills/remember/evals/evals.yaml` -> Trigger and output evals. + 9. `src/skills/adapt/evals/evals.yaml` -> Trigger and output evals. - **Shared Dependencies/Imports:** - - Follow `.agents/skills/create-skill/references/evaluation.md`. + - Follow `src/skills/create-skill/references/evaluation.md`. - Use boundary distinctions from [SPEC.md](../SPEC.md). --- @@ -88,7 +88,7 @@ Scenario: Preserve eval folder discipline *Note to Agent: Execute these steps sequentially. Verify state after each step.* -1. **Analyze & Validate:** Read [SPEC.md](../SPEC.md) Section 8 and `.agents/skills/create-skill/references/evaluation.md`. +1. **Analyze & Validate:** Read [SPEC.md](../SPEC.md) Section 8 and `src/skills/create-skill/references/evaluation.md`. 2. **Generate Eval Cases:** Create prompt-level evals for each new skill. 3. **Check Counts:** Verify each eval file meets the 8-10 target where possible and never drops below 7. 4. **Check Boundary Coverage:** Confirm likely overlaps are represented across the relevant eval files. diff --git a/docs/2026-05-20-general-agent-skills/user-stories/US-003-validate-skills-and-update-index.md b/docs/2026-05-20-general-agent-skills/user-stories/US-003-validate-skills-and-update-index.md index dc16f06..c2c15d9 100644 --- a/docs/2026-05-20-general-agent-skills/user-stories/US-003-validate-skills-and-update-index.md +++ b/docs/2026-05-20-general-agent-skills/user-stories/US-003-validate-skills-and-update-index.md @@ -23,7 +23,7 @@ Source documents: - **In-Scope:** - Run available create-skill validation checks on each new skill. - Review line counts, metadata, section style, and runtime standalone behavior. - - Update `.agents/skills/README.md` if it indexes maintained skills. + - Update `src/skills/README.md` if it indexes maintained skills. - Fix validation failures that are directly related to the new skills. - **Out-of-Scope (Do NOT implement):** - Do not refactor unrelated existing skills. @@ -32,7 +32,7 @@ Source documents: - Do not package or publish skills unless explicitly requested. - **Data Models & Schemas:** - No runtime data model changes. - - README entries shall follow existing `.agents/skills/README.md` conventions. + - README entries shall follow existing `src/skills/README.md` conventions. --- @@ -48,7 +48,7 @@ Scenario: Validate each new skill And any failures are fixed or documented with a clear reason Scenario: Update skill index when present - Given .agents/skills/README.md indexes maintained skills + Given src/skills/README.md indexes maintained skills When the new general skills are ready Then the README includes the new skills using the existing index format And unrelated README sections remain unchanged @@ -67,12 +67,12 @@ Scenario: Prevent runtime coupling *Note to Agent: You are restricted to modifying or analyzing the following components.* - **Primary Target Files:** - 1. `.agents/skills//SKILL.md` -> Validation target. - 2. `.agents/skills//evals/evals.yaml` -> Validation target. - 3. `.agents/skills/README.md` -> Skill index, if present. + 1. `src/skills//SKILL.md` -> Validation target. + 2. `src/skills//evals/evals.yaml` -> Validation target. + 3. `src/skills/README.md` -> Skill index, if present. - **Shared Dependencies/Imports:** - - Use `.agents/skills/create-skill/scripts/validate.py` when available. - - Follow `.agents/skills/create-skill/references/authoring.md`. + - Use `src/skills/create-skill/scripts/validate.py` when available. + - Follow `src/skills/create-skill/references/authoring.md`. --- @@ -80,7 +80,7 @@ Scenario: Prevent runtime coupling *Note to Agent: Execute these steps sequentially. Verify state after each step.* -1. **Analyze & Validate:** Inspect `.agents/skills/README.md` and create-skill validation scripts. +1. **Analyze & Validate:** Inspect `src/skills/README.md` and create-skill validation scripts. 2. **Run Validation:** Run quick validation for each new skill directory. 3. **Fix Failures:** Apply focused fixes to new skill files and evals. 4. **Update Index:** Add new skills to the README only if the README indexes maintained skills. diff --git a/docs/2026-05-20-general-agent-skills/user-stories/US-004-prepare-release-handoff.md b/docs/2026-05-20-general-agent-skills/user-stories/US-004-prepare-release-handoff.md index 7e074cb..57ff170 100644 --- a/docs/2026-05-20-general-agent-skills/user-stories/US-004-prepare-release-handoff.md +++ b/docs/2026-05-20-general-agent-skills/user-stories/US-004-prepare-release-handoff.md @@ -24,14 +24,14 @@ Source documents: - Summarize created or updated skill files. - Summarize validation commands and results. - Note any deviations from the approved SPEC. - - Record durable implementation observations in `.agents/memory/` only if they are useful beyond the task. + - Record durable implementation observations in `src/memory/` only if they are useful beyond the task. - **Out-of-Scope (Do NOT implement):** - Do not create a new PRD, SPEC, architecture doc, or design doc. - Do not record transient task chatter in memory. - Do not mark unresolved validation failures as complete. - **Data Models & Schemas:** - No data model changes. - - Use existing `.agents/memory/` conventions if memory is updated. + - Use existing `src/memory/` conventions if memory is updated. --- @@ -50,7 +50,7 @@ Scenario: Produce implementation handoff Scenario: Record only durable memory Given the implementation produces a reusable project fact or decision When the agent considers memory updates - Then it writes only durable project value to .agents/memory/ + Then it writes only durable project value to src/memory/ And it avoids duplicating the PRD, SPEC, or story contents Scenario: Avoid false completion @@ -67,12 +67,12 @@ Scenario: Avoid false completion *Note to Agent: You are restricted to modifying or analyzing the following components.* - **Primary Target Files:** - 1. `.agents/skills//` -> Created skill artifacts. - 2. `.agents/skills/README.md` -> Index updates, if any. - 3. `.agents/memory/YYYY-MM-DD.md` -> Optional durable implementation notes. + 1. `src/skills//` -> Created skill artifacts. + 2. `src/skills/README.md` -> Index updates, if any. + 3. `src/memory/YYYY-MM-DD.md` -> Optional durable implementation notes. - **Shared Dependencies/Imports:** - Use [SPEC.md](../SPEC.md) as the completion contract. - - Use existing `.agents/memory/MEMORY.md` and dated memory conventions. + - Use existing `src/memory/MEMORY.md` and dated memory conventions. --- diff --git a/docs/2026-05-23-design-principles/PRD.md b/docs/2026-05-23-design-principles/PRD.md index 9124618..cd8c3d1 100644 --- a/docs/2026-05-23-design-principles/PRD.md +++ b/docs/2026-05-23-design-principles/PRD.md @@ -33,7 +33,7 @@ Without this integration, agents may apply principles inconsistently: overusing | Goal ID | Target Outcome | Success Metric | | --- | --- | --- | -| G-1 | Establish a shared engineering-principles rule for `.agents`. | One concise global rule exists under `.agents/rules/` and is referenced by implementation-facing skills where useful. | +| G-1 | Establish a shared engineering-principles rule for `.agents`. | One concise global rule exists under `src/rules/` and is referenced by implementation-facing skills where useful. | | G-2 | Make principles operational in code-writing and code-review workflows. | `code-backend`, `code-frontend`, `code-database`, `code-tests`, `review-code`, and `create-skill` apply relevant principle lenses without duplicating the full source document. | | G-3 | Keep runtime instructions token-efficient. | New or edited runtime guidance is concise and avoids copying the entire collected principles list into every skill. | | G-4 | Preserve pragmatic judgment. | Guidance explicitly treats KISS and YAGNI as default brakes, DRY as knowledge deduplication, and SOLID as useful only when it reduces real coupling or change risk. | @@ -52,7 +52,7 @@ Without this integration, agents may apply principles inconsistently: overusing ### In Scope -- Create a compact `.agents/rules/engineering-principles.md` rule. +- Create a compact `src/rules/engineering-principles.md` rule. - Translate SOLID, DRY, KISS, YAGNI, Law of Demeter, Composition Over Inheritance, Boy Scout Rule, CQS, and Separation of Concerns into practical agent behavior. - Update selected implementation and review skills only where the principle changes expected behavior. - Add or update focused eval prompts where needed to check that agents avoid over-engineering, speculative abstraction, and vague principle-name dropping. @@ -77,7 +77,7 @@ Without this integration, agents may apply principles inconsistently: overusing | Requirement ID | Capability / Feature | Priority | Acceptance Criteria | Tracker | | --- | --- | --- | --- | --- | -| FR-1 | Define a global engineering-principles rule. | MUST | A new `.agents/rules/engineering-principles.md` exists with metadata, scope, and concise guidance for applying the collected principles pragmatically. | TBD | +| FR-1 | Define a global engineering-principles rule. | MUST | A new `src/rules/engineering-principles.md` exists with metadata, scope, and concise guidance for applying the collected principles pragmatically. | TBD | | FR-2 | Prioritize simplicity before abstraction. | MUST | The rule states that KISS and YAGNI are default constraints for implementation and that new abstractions require evidence of reduced complexity, duplication of knowledge, coupling, or test risk. | TBD | | FR-3 | Clarify DRY behavior. | MUST | Guidance distinguishes duplicated knowledge or business logic from harmless repeated syntax, markup, or test setup. | TBD | | FR-4 | Clarify SOLID behavior. | MUST | Guidance applies SRP, ISP, DIP, and related principles through clear responsibilities, small interfaces, and explicit dependencies without adding ceremonial layers. | TBD | @@ -136,7 +136,7 @@ Without this integration, agents may apply principles inconsistently: overusing | Dependency ID | Item | Impacted Requirements | Validation Owner | | --- | --- | --- | --- | | D-1 | `docs/2026-05-23-design-principles/Most Popular Principles.md` | FR-1 through FR-5 | Oleg Shulyakov | -| D-2 | Existing `.agents/rules/karpathy-guidelines.md` | FR-1, FR-2, FR-5 | Oleg Shulyakov | +| D-2 | Existing `src/rules/karpathy-guidelines.md` | FR-1, FR-2, FR-5 | Oleg Shulyakov | | D-3 | Existing implementation and review skills | FR-6, FR-7 | TBD | --- @@ -154,4 +154,4 @@ Without this integration, agents may apply principles inconsistently: overusing ## Reference Links - **Ref-1**: Source principles collection - `docs/2026-05-23-design-principles/Most Popular Principles.md` -- **Ref-2**: Existing simplicity and verification guidance - `.agents/rules/karpathy-guidelines.md` +- **Ref-2**: Existing simplicity and verification guidance - `src/rules/karpathy-guidelines.md` diff --git a/docs/2026-05-23-design-principles/SPEC.md b/docs/2026-05-23-design-principles/SPEC.md index 8d77489..a014cb4 100644 --- a/docs/2026-05-23-design-principles/SPEC.md +++ b/docs/2026-05-23-design-principles/SPEC.md @@ -99,7 +99,7 @@ Users rely on this skill library to produce code, reviews, docs, and agent artif **Priority:** Must-have **Actor:** Skill maintainer -**Description:** The system shall define `.agents/rules/engineering-principles.md` as the concise shared source for applying engineering principles. +**Description:** The system shall define `src/rules/engineering-principles.md` as the concise shared source for applying engineering principles. **Acceptance criteria:** - [ ] File includes frontmatter with `name`, `description`, `applies_to`, `priority`, and metadata consistent with existing rules. @@ -206,7 +206,7 @@ The integration uses a layered documentation model: ```mermaid flowchart TD - Source["Most Popular Principles.md"] --> Rule[".agents/rules/engineering-principles.md"] + Source["Most Popular Principles.md"] --> Rule["src/rules/engineering-principles.md"] Rule --> Backend["code-backend"] Rule --> Frontend["code-frontend"] Rule --> Database["code-database"] @@ -232,7 +232,7 @@ The source document remains the collected reference. The new rule becomes the ru #### Decision: Start With a Rule, Not a Skill -- **Chosen:** Add `.agents/rules/engineering-principles.md`. +- **Chosen:** Add `src/rules/engineering-principles.md`. - **Rationale:** The principles should influence many tasks without requiring a user to ask for an explicit skill. - **Trade-off:** The rule cannot provide deep teaching examples. Those can remain in docs or later references. @@ -279,7 +279,7 @@ No production observability changes are required. Development-time validation sh | Level | Scope | Tools | Coverage Target | | --- | --- | --- | --- | | Markdown lint | Changed Markdown files | `markdownlint` or `markdownlint-cli2` | No lint errors, unless documented | -| Skill validation | Changed skills | `.agents/skills/create-skill/scripts/validate.py` | Pass for every changed skill | +| Skill validation | Changed skills | `src/skills/create-skill/scripts/validate.py` | Pass for every changed skill | | Eval prompts | Principle-specific behavior | Existing skill eval workflow | Added only where behavior risk justifies it | | Manual review | Runtime wording | Human review | No duplicated full principle catalog or vague principle boilerplate | @@ -299,9 +299,9 @@ No personal data handling changes are expected. Verify that new wording does not ### Phase 2: Global Rule -- [ ] Add `.agents/rules/engineering-principles.md`. +- [ ] Add `src/rules/engineering-principles.md`. - [ ] Keep rule concise and consistent with existing rule metadata. -- [ ] Cross-check overlap with `.agents/rules/karpathy-guidelines.md`. +- [ ] Cross-check overlap with `src/rules/karpathy-guidelines.md`. ### Phase 3: Targeted Skill Updates diff --git a/.agents/commands/git-branch.md b/src/commands/git-branch.md similarity index 100% rename from .agents/commands/git-branch.md rename to src/commands/git-branch.md diff --git a/.agents/commands/git-message.md b/src/commands/git-message.md similarity index 100% rename from .agents/commands/git-message.md rename to src/commands/git-message.md diff --git a/.agents/memory/2026-05-02.md b/src/memory/2026-05-02.md similarity index 91% rename from .agents/memory/2026-05-02.md rename to src/memory/2026-05-02.md index c1fb698..51628df 100644 --- a/.agents/memory/2026-05-02.md +++ b/src/memory/2026-05-02.md @@ -9,4 +9,4 @@ Repository bootstrap and initial playbook documentation. - Initialized the repository with Jekyll configuration. - Added the first generated agent playbook documentation. - Added software team skill set documents and early folder-based naming guidance. -- Early documentation still used `.agent/` naming after an initial `.agents/` to `.agent/` pass. +- Early documentation still used `.agent/` naming after an initial `src/` to `.agent/` pass. diff --git a/.agents/memory/2026-05-03.md b/src/memory/2026-05-03.md similarity index 100% rename from .agents/memory/2026-05-03.md rename to src/memory/2026-05-03.md diff --git a/.agents/memory/2026-05-04.md b/src/memory/2026-05-04.md similarity index 100% rename from .agents/memory/2026-05-04.md rename to src/memory/2026-05-04.md diff --git a/.agents/memory/2026-05-09.md b/src/memory/2026-05-09.md similarity index 100% rename from .agents/memory/2026-05-09.md rename to src/memory/2026-05-09.md diff --git a/.agents/memory/2026-05-11.md b/src/memory/2026-05-11.md similarity index 84% rename from .agents/memory/2026-05-11.md rename to src/memory/2026-05-11.md index 88d350f..0ece9d5 100644 --- a/.agents/memory/2026-05-11.md +++ b/src/memory/2026-05-11.md @@ -2,7 +2,7 @@ ## Context -The playbook moved toward `AGENTS.md`, `.agents/`, and router-style skills. +The playbook moved toward `AGENTS.md`, `src/`, and router-style skills. ## Observations diff --git a/.agents/memory/2026-05-12.md b/src/memory/2026-05-12.md similarity index 100% rename from .agents/memory/2026-05-12.md rename to src/memory/2026-05-12.md diff --git a/.agents/memory/2026-05-13.md b/src/memory/2026-05-13.md similarity index 100% rename from .agents/memory/2026-05-13.md rename to src/memory/2026-05-13.md diff --git a/.agents/memory/2026-05-14.md b/src/memory/2026-05-14.md similarity index 100% rename from .agents/memory/2026-05-14.md rename to src/memory/2026-05-14.md diff --git a/.agents/memory/2026-05-15.md b/src/memory/2026-05-15.md similarity index 90% rename from .agents/memory/2026-05-15.md rename to src/memory/2026-05-15.md index 76e3a18..a96ee76 100644 --- a/.agents/memory/2026-05-15.md +++ b/src/memory/2026-05-15.md @@ -6,7 +6,7 @@ Skill generation, backend implementation, and small-task memory conventions matu ## Observations -- Moved small task notes into `.agents/memory/YYYY-MM-DD.md`. +- Moved small task notes into `src/memory/YYYY-MM-DD.md`. - Added `design-api` as a router skill with OpenAPI, AsyncAPI, and GraphQL references. - Added the Agent PDLC diagram in `pages/AGENT_PDLC.md`. - Added `codegen-test` and `codegen-backend` skills. diff --git a/.agents/memory/2026-05-16.md b/src/memory/2026-05-16.md similarity index 100% rename from .agents/memory/2026-05-16.md rename to src/memory/2026-05-16.md diff --git a/.agents/memory/2026-05-17.md b/src/memory/2026-05-17.md similarity index 100% rename from .agents/memory/2026-05-17.md rename to src/memory/2026-05-17.md diff --git a/.agents/memory/2026-05-18.md b/src/memory/2026-05-18.md similarity index 79% rename from .agents/memory/2026-05-18.md rename to src/memory/2026-05-18.md index 677f158..05bb735 100644 --- a/.agents/memory/2026-05-18.md +++ b/src/memory/2026-05-18.md @@ -6,8 +6,8 @@ Markdown tooling, always-on guidance, Pages polish, and review/explanation skill ## Observations -- Added `.agents/rules/formatting-markdown.md` for Markdown-only formatting guidance and scoped it to Markdown files. -- Updated `.markdownlint.yaml` so `.agents/commands/*.md` may start with YAML frontmatter instead of a first-line heading. +- Added `src/rules/formatting-markdown.md` for Markdown-only formatting guidance and scoped it to Markdown files. +- Updated `.markdownlint.yaml` so `src/commands/*.md` may start with YAML frontmatter instead of a first-line heading. - Consolidated Markdown tooling into `.devops/js-tools`, added markdownlint scripts, and renamed token tallying to `token-count`. - Added `.github/workflows/library-token-diff.yml` to comment library token diffs on PRs that change library content. - Moved `artifact-quality` and `token-efficiency` into root `AGENTS.md` as always-on guidance and removed separate library rule files. diff --git a/.agents/memory/2026-05-19.md b/src/memory/2026-05-19.md similarity index 100% rename from .agents/memory/2026-05-19.md rename to src/memory/2026-05-19.md diff --git a/.agents/memory/2026-05-20.md b/src/memory/2026-05-20.md similarity index 100% rename from .agents/memory/2026-05-20.md rename to src/memory/2026-05-20.md diff --git a/.agents/memory/2026-05-21.md b/src/memory/2026-05-21.md similarity index 100% rename from .agents/memory/2026-05-21.md rename to src/memory/2026-05-21.md diff --git a/.agents/memory/2026-05-23.md b/src/memory/2026-05-23.md similarity index 100% rename from .agents/memory/2026-05-23.md rename to src/memory/2026-05-23.md diff --git a/.agents/memory/2026-05-24.md b/src/memory/2026-05-24.md similarity index 100% rename from .agents/memory/2026-05-24.md rename to src/memory/2026-05-24.md diff --git a/.agents/memory/MEMORY.md b/src/memory/MEMORY.md similarity index 86% rename from .agents/memory/MEMORY.md rename to src/memory/MEMORY.md index e1ade6c..61cff90 100644 --- a/.agents/memory/MEMORY.md +++ b/src/memory/MEMORY.md @@ -3,14 +3,14 @@ ## Facts - **Root `AGENTS.md` is the primary entry point** — Playbook docs were updated on 2026-05-12 to make root `AGENTS.md` the concrete entry point for agent guidance. -- **Memory stores small completed task notes** — Use `.agents/memory/YYYY-MM-DD.md` for small task observations that do not need a PRD, SPEC, architecture, or design document. +- **Memory stores small completed task notes** — Use `src/memory/YYYY-MM-DD.md` for small task observations that do not need a PRD, SPEC, architecture, or design document. - **Dated memory uses UTC** — Daily notes use `YYYY-MM-DD` filenames and UTC dating. - **GitHub Pages source lives in `pages/`** — Repository Pages files were moved from the root into `pages/` on 2026-05-14. - **JavaScript tooling lives in `.devops/js-tools`** — Markdown linting and token counting were consolidated there; `token-count` is the current token script name. - **Library content lives under `.agents`** — The maintained library was moved under `.agents` on 2026-05-19. -- **Library skills have a table-of-contents README** — `.agents/skills/README.md` indexes the maintained skills. +- **Library skills have a table-of-contents README** — `src/skills/README.md` indexes the maintained skills. - **Router skills are the preferred pattern for multi-variant skills** — Multi-variant skill families such as Git, API design, database/code generation, and frontend/backend generation route to focused references. -- **Creator skills support multiple agent runtimes** — `.agents/skills/create-skill` guidance and scripts avoid assuming a single coding-agent runtime. +- **Creator skills support multiple agent runtimes** — `src/skills/create-skill` guidance and scripts avoid assuming a single coding-agent runtime. - **Skill audit tasks are grouped by skill** — When auditing skill format or authoring compliance, write remediation checklists as one top-level task per skill folder; put style, structure, reference, and validation fixes under that skill. - **Agent artifact metadata is compact** — Skills, rules, and commands store `author`, `version`, `source`, and `category` under `metadata`; use compact source references such as `github.com/olegshulyakov/agent.md`. - **Generated docs use YAML frontmatter for document metadata** — PRDs, specs, stories, runbooks, and similar generated Markdown artifacts put document-level metadata in frontmatter instead of body metadata tables or `Document Info` blocks. @@ -26,7 +26,7 @@ ### [2026-05-14] Use memory for small completed task notes **Context:** Several `docs/2026-05-14-*` folders contained only completed `TASKS.md` files. -**Decision:** Preserve those notes in `.agents/memory/2026-05-14.md` and reserve docs task folders for work that needs task-scoped PRD, SPEC, architecture, or design documentation. +**Decision:** Preserve those notes in `src/memory/2026-05-14.md` and reserve docs task folders for work that needs task-scoped PRD, SPEC, architecture, or design documentation. **Revisit if:** Small tasks start needing richer traceability than dated memory notes provide. ### [2026-05-24] Use YAML frontmatter for generated document metadata diff --git a/.agents/rules/formatting-markdown.md b/src/rules/formatting-markdown.md similarity index 100% rename from .agents/rules/formatting-markdown.md rename to src/rules/formatting-markdown.md diff --git a/.agents/rules/karpathy-guidelines.md b/src/rules/karpathy-guidelines.md similarity index 100% rename from .agents/rules/karpathy-guidelines.md rename to src/rules/karpathy-guidelines.md diff --git a/.agents/skills/README.md b/src/skills/README.md similarity index 100% rename from .agents/skills/README.md rename to src/skills/README.md diff --git a/.agents/skills/adapt/SKILL.md b/src/skills/adapt/SKILL.md similarity index 97% rename from .agents/skills/adapt/SKILL.md rename to src/skills/adapt/SKILL.md index c8bd4a4..1c8d7f1 100644 --- a/.agents/skills/adapt/SKILL.md +++ b/src/skills/adapt/SKILL.md @@ -8,7 +8,7 @@ tags: - process metadata: author: Oleg Shulyakov - version: "1.3.0" + version: "1.3.1" source: github.com/olegshulyakov/agent.md catalog: utility category: productivity @@ -75,7 +75,7 @@ Feature: Diagnose and act on a mismatch signal And copy the skill to a writable location before editing if the source is read-only Scenario: Target is a rule - Given the target artifact is a rule file (.agents/rules/, CLAUDE.md, AGENTS.md, etc.) + Given the target artifact is a rule file (`rules/.md`, `CLAUDE.md`, `AGENTS.md`, etc.) Then invoke creator-rule to write or update the rule And check for conflicts with existing rules before writing And scope the rule narrowly — one concern per file diff --git a/.agents/skills/ask/SKILL.md b/src/skills/ask/SKILL.md similarity index 100% rename from .agents/skills/ask/SKILL.md rename to src/skills/ask/SKILL.md diff --git a/.agents/skills/audit-skill-security/SKILL.md b/src/skills/audit-skill-security/SKILL.md similarity index 100% rename from .agents/skills/audit-skill-security/SKILL.md rename to src/skills/audit-skill-security/SKILL.md diff --git a/.agents/skills/audit-skill-security/references/audit-protocol.md b/src/skills/audit-skill-security/references/audit-protocol.md similarity index 100% rename from .agents/skills/audit-skill-security/references/audit-protocol.md rename to src/skills/audit-skill-security/references/audit-protocol.md diff --git a/.agents/skills/brainstorm/SKILL.md b/src/skills/brainstorm/SKILL.md similarity index 100% rename from .agents/skills/brainstorm/SKILL.md rename to src/skills/brainstorm/SKILL.md diff --git a/.agents/skills/choose/SKILL.md b/src/skills/choose/SKILL.md similarity index 100% rename from .agents/skills/choose/SKILL.md rename to src/skills/choose/SKILL.md diff --git a/.agents/skills/classify/SKILL.md b/src/skills/classify/SKILL.md similarity index 100% rename from .agents/skills/classify/SKILL.md rename to src/skills/classify/SKILL.md diff --git a/.agents/skills/code-backend/SKILL.md b/src/skills/code-backend/SKILL.md similarity index 100% rename from .agents/skills/code-backend/SKILL.md rename to src/skills/code-backend/SKILL.md diff --git a/.agents/skills/code-backend/references/ada.md b/src/skills/code-backend/references/ada.md similarity index 100% rename from .agents/skills/code-backend/references/ada.md rename to src/skills/code-backend/references/ada.md diff --git a/.agents/skills/code-backend/references/c.md b/src/skills/code-backend/references/c.md similarity index 100% rename from .agents/skills/code-backend/references/c.md rename to src/skills/code-backend/references/c.md diff --git a/.agents/skills/code-backend/references/cpp.md b/src/skills/code-backend/references/cpp.md similarity index 100% rename from .agents/skills/code-backend/references/cpp.md rename to src/skills/code-backend/references/cpp.md diff --git a/.agents/skills/code-backend/references/csharp-aspnet-core.md b/src/skills/code-backend/references/csharp-aspnet-core.md similarity index 100% rename from .agents/skills/code-backend/references/csharp-aspnet-core.md rename to src/skills/code-backend/references/csharp-aspnet-core.md diff --git a/.agents/skills/code-backend/references/csharp.md b/src/skills/code-backend/references/csharp.md similarity index 100% rename from .agents/skills/code-backend/references/csharp.md rename to src/skills/code-backend/references/csharp.md diff --git a/.agents/skills/code-backend/references/delphi.md b/src/skills/code-backend/references/delphi.md similarity index 100% rename from .agents/skills/code-backend/references/delphi.md rename to src/skills/code-backend/references/delphi.md diff --git a/.agents/skills/code-backend/references/elixir-phoenix.md b/src/skills/code-backend/references/elixir-phoenix.md similarity index 100% rename from .agents/skills/code-backend/references/elixir-phoenix.md rename to src/skills/code-backend/references/elixir-phoenix.md diff --git a/.agents/skills/code-backend/references/elixir.md b/src/skills/code-backend/references/elixir.md similarity index 100% rename from .agents/skills/code-backend/references/elixir.md rename to src/skills/code-backend/references/elixir.md diff --git a/.agents/skills/code-backend/references/fortran.md b/src/skills/code-backend/references/fortran.md similarity index 100% rename from .agents/skills/code-backend/references/fortran.md rename to src/skills/code-backend/references/fortran.md diff --git a/.agents/skills/code-backend/references/go-chi.md b/src/skills/code-backend/references/go-chi.md similarity index 100% rename from .agents/skills/code-backend/references/go-chi.md rename to src/skills/code-backend/references/go-chi.md diff --git a/.agents/skills/code-backend/references/go-echo.md b/src/skills/code-backend/references/go-echo.md similarity index 100% rename from .agents/skills/code-backend/references/go-echo.md rename to src/skills/code-backend/references/go-echo.md diff --git a/.agents/skills/code-backend/references/go-fiber.md b/src/skills/code-backend/references/go-fiber.md similarity index 100% rename from .agents/skills/code-backend/references/go-fiber.md rename to src/skills/code-backend/references/go-fiber.md diff --git a/.agents/skills/code-backend/references/go-gin.md b/src/skills/code-backend/references/go-gin.md similarity index 100% rename from .agents/skills/code-backend/references/go-gin.md rename to src/skills/code-backend/references/go-gin.md diff --git a/.agents/skills/code-backend/references/go.md b/src/skills/code-backend/references/go.md similarity index 100% rename from .agents/skills/code-backend/references/go.md rename to src/skills/code-backend/references/go.md diff --git a/.agents/skills/code-backend/references/java-micronaut.md b/src/skills/code-backend/references/java-micronaut.md similarity index 100% rename from .agents/skills/code-backend/references/java-micronaut.md rename to src/skills/code-backend/references/java-micronaut.md diff --git a/.agents/skills/code-backend/references/java-quarkus.md b/src/skills/code-backend/references/java-quarkus.md similarity index 100% rename from .agents/skills/code-backend/references/java-quarkus.md rename to src/skills/code-backend/references/java-quarkus.md diff --git a/.agents/skills/code-backend/references/java-spring-boot.md b/src/skills/code-backend/references/java-spring-boot.md similarity index 100% rename from .agents/skills/code-backend/references/java-spring-boot.md rename to src/skills/code-backend/references/java-spring-boot.md diff --git a/.agents/skills/code-backend/references/java.md b/src/skills/code-backend/references/java.md similarity index 100% rename from .agents/skills/code-backend/references/java.md rename to src/skills/code-backend/references/java.md diff --git a/.agents/skills/code-backend/references/kotlin-ktor.md b/src/skills/code-backend/references/kotlin-ktor.md similarity index 100% rename from .agents/skills/code-backend/references/kotlin-ktor.md rename to src/skills/code-backend/references/kotlin-ktor.md diff --git a/.agents/skills/code-backend/references/kotlin.md b/src/skills/code-backend/references/kotlin.md similarity index 100% rename from .agents/skills/code-backend/references/kotlin.md rename to src/skills/code-backend/references/kotlin.md diff --git a/.agents/skills/code-backend/references/matlab.md b/src/skills/code-backend/references/matlab.md similarity index 100% rename from .agents/skills/code-backend/references/matlab.md rename to src/skills/code-backend/references/matlab.md diff --git a/.agents/skills/code-backend/references/nodejs-express.md b/src/skills/code-backend/references/nodejs-express.md similarity index 100% rename from .agents/skills/code-backend/references/nodejs-express.md rename to src/skills/code-backend/references/nodejs-express.md diff --git a/.agents/skills/code-backend/references/nodejs-fastify.md b/src/skills/code-backend/references/nodejs-fastify.md similarity index 100% rename from .agents/skills/code-backend/references/nodejs-fastify.md rename to src/skills/code-backend/references/nodejs-fastify.md diff --git a/.agents/skills/code-backend/references/nodejs-hono.md b/src/skills/code-backend/references/nodejs-hono.md similarity index 100% rename from .agents/skills/code-backend/references/nodejs-hono.md rename to src/skills/code-backend/references/nodejs-hono.md diff --git a/.agents/skills/code-backend/references/nodejs-nestjs.md b/src/skills/code-backend/references/nodejs-nestjs.md similarity index 100% rename from .agents/skills/code-backend/references/nodejs-nestjs.md rename to src/skills/code-backend/references/nodejs-nestjs.md diff --git a/.agents/skills/code-backend/references/nodejs-nitro.md b/src/skills/code-backend/references/nodejs-nitro.md similarity index 100% rename from .agents/skills/code-backend/references/nodejs-nitro.md rename to src/skills/code-backend/references/nodejs-nitro.md diff --git a/.agents/skills/code-backend/references/nodejs.md b/src/skills/code-backend/references/nodejs.md similarity index 100% rename from .agents/skills/code-backend/references/nodejs.md rename to src/skills/code-backend/references/nodejs.md diff --git a/.agents/skills/code-backend/references/perl.md b/src/skills/code-backend/references/perl.md similarity index 100% rename from .agents/skills/code-backend/references/perl.md rename to src/skills/code-backend/references/perl.md diff --git a/.agents/skills/code-backend/references/php-laravel.md b/src/skills/code-backend/references/php-laravel.md similarity index 100% rename from .agents/skills/code-backend/references/php-laravel.md rename to src/skills/code-backend/references/php-laravel.md diff --git a/.agents/skills/code-backend/references/php-symfony.md b/src/skills/code-backend/references/php-symfony.md similarity index 100% rename from .agents/skills/code-backend/references/php-symfony.md rename to src/skills/code-backend/references/php-symfony.md diff --git a/.agents/skills/code-backend/references/php.md b/src/skills/code-backend/references/php.md similarity index 100% rename from .agents/skills/code-backend/references/php.md rename to src/skills/code-backend/references/php.md diff --git a/.agents/skills/code-backend/references/python-django.md b/src/skills/code-backend/references/python-django.md similarity index 100% rename from .agents/skills/code-backend/references/python-django.md rename to src/skills/code-backend/references/python-django.md diff --git a/.agents/skills/code-backend/references/python-fastapi.md b/src/skills/code-backend/references/python-fastapi.md similarity index 100% rename from .agents/skills/code-backend/references/python-fastapi.md rename to src/skills/code-backend/references/python-fastapi.md diff --git a/.agents/skills/code-backend/references/python-flask.md b/src/skills/code-backend/references/python-flask.md similarity index 100% rename from .agents/skills/code-backend/references/python-flask.md rename to src/skills/code-backend/references/python-flask.md diff --git a/.agents/skills/code-backend/references/python.md b/src/skills/code-backend/references/python.md similarity index 100% rename from .agents/skills/code-backend/references/python.md rename to src/skills/code-backend/references/python.md diff --git a/.agents/skills/code-backend/references/r.md b/src/skills/code-backend/references/r.md similarity index 100% rename from .agents/skills/code-backend/references/r.md rename to src/skills/code-backend/references/r.md diff --git a/.agents/skills/code-backend/references/ruby-rails.md b/src/skills/code-backend/references/ruby-rails.md similarity index 100% rename from .agents/skills/code-backend/references/ruby-rails.md rename to src/skills/code-backend/references/ruby-rails.md diff --git a/.agents/skills/code-backend/references/ruby-sinatra.md b/src/skills/code-backend/references/ruby-sinatra.md similarity index 100% rename from .agents/skills/code-backend/references/ruby-sinatra.md rename to src/skills/code-backend/references/ruby-sinatra.md diff --git a/.agents/skills/code-backend/references/ruby.md b/src/skills/code-backend/references/ruby.md similarity index 100% rename from .agents/skills/code-backend/references/ruby.md rename to src/skills/code-backend/references/ruby.md diff --git a/.agents/skills/code-backend/references/rust-actix-web.md b/src/skills/code-backend/references/rust-actix-web.md similarity index 100% rename from .agents/skills/code-backend/references/rust-actix-web.md rename to src/skills/code-backend/references/rust-actix-web.md diff --git a/.agents/skills/code-backend/references/rust-axum.md b/src/skills/code-backend/references/rust-axum.md similarity index 100% rename from .agents/skills/code-backend/references/rust-axum.md rename to src/skills/code-backend/references/rust-axum.md diff --git a/.agents/skills/code-backend/references/rust-rocket.md b/src/skills/code-backend/references/rust-rocket.md similarity index 100% rename from .agents/skills/code-backend/references/rust-rocket.md rename to src/skills/code-backend/references/rust-rocket.md diff --git a/.agents/skills/code-backend/references/rust.md b/src/skills/code-backend/references/rust.md similarity index 100% rename from .agents/skills/code-backend/references/rust.md rename to src/skills/code-backend/references/rust.md diff --git a/.agents/skills/code-backend/references/swift.md b/src/skills/code-backend/references/swift.md similarity index 100% rename from .agents/skills/code-backend/references/swift.md rename to src/skills/code-backend/references/swift.md diff --git a/.agents/skills/code-backend/references/visual-basic.md b/src/skills/code-backend/references/visual-basic.md similarity index 100% rename from .agents/skills/code-backend/references/visual-basic.md rename to src/skills/code-backend/references/visual-basic.md diff --git a/.agents/skills/code-database/SKILL.md b/src/skills/code-database/SKILL.md similarity index 100% rename from .agents/skills/code-database/SKILL.md rename to src/skills/code-database/SKILL.md diff --git a/.agents/skills/code-database/references/analytics.md b/src/skills/code-database/references/analytics.md similarity index 100% rename from .agents/skills/code-database/references/analytics.md rename to src/skills/code-database/references/analytics.md diff --git a/.agents/skills/code-database/references/bigquery.md b/src/skills/code-database/references/bigquery.md similarity index 100% rename from .agents/skills/code-database/references/bigquery.md rename to src/skills/code-database/references/bigquery.md diff --git a/.agents/skills/code-database/references/clickhouse.md b/src/skills/code-database/references/clickhouse.md similarity index 100% rename from .agents/skills/code-database/references/clickhouse.md rename to src/skills/code-database/references/clickhouse.md diff --git a/.agents/skills/code-database/references/cockroachdb.md b/src/skills/code-database/references/cockroachdb.md similarity index 100% rename from .agents/skills/code-database/references/cockroachdb.md rename to src/skills/code-database/references/cockroachdb.md diff --git a/.agents/skills/code-database/references/common.md b/src/skills/code-database/references/common.md similarity index 100% rename from .agents/skills/code-database/references/common.md rename to src/skills/code-database/references/common.md diff --git a/.agents/skills/code-database/references/migration.md b/src/skills/code-database/references/migration.md similarity index 100% rename from .agents/skills/code-database/references/migration.md rename to src/skills/code-database/references/migration.md diff --git a/.agents/skills/code-database/references/mssql.md b/src/skills/code-database/references/mssql.md similarity index 100% rename from .agents/skills/code-database/references/mssql.md rename to src/skills/code-database/references/mssql.md diff --git a/.agents/skills/code-database/references/mysql.md b/src/skills/code-database/references/mysql.md similarity index 100% rename from .agents/skills/code-database/references/mysql.md rename to src/skills/code-database/references/mysql.md diff --git a/.agents/skills/code-database/references/oracle.md b/src/skills/code-database/references/oracle.md similarity index 100% rename from .agents/skills/code-database/references/oracle.md rename to src/skills/code-database/references/oracle.md diff --git a/.agents/skills/code-database/references/postgres.md b/src/skills/code-database/references/postgres.md similarity index 100% rename from .agents/skills/code-database/references/postgres.md rename to src/skills/code-database/references/postgres.md diff --git a/.agents/skills/code-database/references/schema-design.md b/src/skills/code-database/references/schema-design.md similarity index 100% rename from .agents/skills/code-database/references/schema-design.md rename to src/skills/code-database/references/schema-design.md diff --git a/.agents/skills/code-database/references/snowflake.md b/src/skills/code-database/references/snowflake.md similarity index 100% rename from .agents/skills/code-database/references/snowflake.md rename to src/skills/code-database/references/snowflake.md diff --git a/.agents/skills/code-database/references/sqlite.md b/src/skills/code-database/references/sqlite.md similarity index 100% rename from .agents/skills/code-database/references/sqlite.md rename to src/skills/code-database/references/sqlite.md diff --git a/.agents/skills/code-frontend/SKILL.md b/src/skills/code-frontend/SKILL.md similarity index 100% rename from .agents/skills/code-frontend/SKILL.md rename to src/skills/code-frontend/SKILL.md diff --git a/.agents/skills/code-frontend/references/accessibility.md b/src/skills/code-frontend/references/accessibility.md similarity index 100% rename from .agents/skills/code-frontend/references/accessibility.md rename to src/skills/code-frontend/references/accessibility.md diff --git a/.agents/skills/code-frontend/references/css-bootstrap.md b/src/skills/code-frontend/references/css-bootstrap.md similarity index 100% rename from .agents/skills/code-frontend/references/css-bootstrap.md rename to src/skills/code-frontend/references/css-bootstrap.md diff --git a/.agents/skills/code-frontend/references/css-component-libraries.md b/src/skills/code-frontend/references/css-component-libraries.md similarity index 100% rename from .agents/skills/code-frontend/references/css-component-libraries.md rename to src/skills/code-frontend/references/css-component-libraries.md diff --git a/.agents/skills/code-frontend/references/css-tailwind.md b/src/skills/code-frontend/references/css-tailwind.md similarity index 100% rename from .agents/skills/code-frontend/references/css-tailwind.md rename to src/skills/code-frontend/references/css-tailwind.md diff --git a/.agents/skills/code-frontend/references/css.md b/src/skills/code-frontend/references/css.md similarity index 100% rename from .agents/skills/code-frontend/references/css.md rename to src/skills/code-frontend/references/css.md diff --git a/.agents/skills/code-frontend/references/forms.md b/src/skills/code-frontend/references/forms.md similarity index 100% rename from .agents/skills/code-frontend/references/forms.md rename to src/skills/code-frontend/references/forms.md diff --git a/.agents/skills/code-frontend/references/html.md b/src/skills/code-frontend/references/html.md similarity index 100% rename from .agents/skills/code-frontend/references/html.md rename to src/skills/code-frontend/references/html.md diff --git a/.agents/skills/code-frontend/references/internationalization.md b/src/skills/code-frontend/references/internationalization.md similarity index 100% rename from .agents/skills/code-frontend/references/internationalization.md rename to src/skills/code-frontend/references/internationalization.md diff --git a/.agents/skills/code-frontend/references/javascript-angular.md b/src/skills/code-frontend/references/javascript-angular.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-angular.md rename to src/skills/code-frontend/references/javascript-angular.md diff --git a/.agents/skills/code-frontend/references/javascript-astro.md b/src/skills/code-frontend/references/javascript-astro.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-astro.md rename to src/skills/code-frontend/references/javascript-astro.md diff --git a/.agents/skills/code-frontend/references/javascript-react-nextjs.md b/src/skills/code-frontend/references/javascript-react-nextjs.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-react-nextjs.md rename to src/skills/code-frontend/references/javascript-react-nextjs.md diff --git a/.agents/skills/code-frontend/references/javascript-react-remix.md b/src/skills/code-frontend/references/javascript-react-remix.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-react-remix.md rename to src/skills/code-frontend/references/javascript-react-remix.md diff --git a/.agents/skills/code-frontend/references/javascript-react.md b/src/skills/code-frontend/references/javascript-react.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-react.md rename to src/skills/code-frontend/references/javascript-react.md diff --git a/.agents/skills/code-frontend/references/javascript-solidjs.md b/src/skills/code-frontend/references/javascript-solidjs.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-solidjs.md rename to src/skills/code-frontend/references/javascript-solidjs.md diff --git a/.agents/skills/code-frontend/references/javascript-svelte-sveltekit.md b/src/skills/code-frontend/references/javascript-svelte-sveltekit.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-svelte-sveltekit.md rename to src/skills/code-frontend/references/javascript-svelte-sveltekit.md diff --git a/.agents/skills/code-frontend/references/javascript-svelte.md b/src/skills/code-frontend/references/javascript-svelte.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-svelte.md rename to src/skills/code-frontend/references/javascript-svelte.md diff --git a/.agents/skills/code-frontend/references/javascript-vue-nuxt.md b/src/skills/code-frontend/references/javascript-vue-nuxt.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-vue-nuxt.md rename to src/skills/code-frontend/references/javascript-vue-nuxt.md diff --git a/.agents/skills/code-frontend/references/javascript-vue.md b/src/skills/code-frontend/references/javascript-vue.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript-vue.md rename to src/skills/code-frontend/references/javascript-vue.md diff --git a/.agents/skills/code-frontend/references/javascript.md b/src/skills/code-frontend/references/javascript.md similarity index 100% rename from .agents/skills/code-frontend/references/javascript.md rename to src/skills/code-frontend/references/javascript.md diff --git a/.agents/skills/code-frontend/references/performance.md b/src/skills/code-frontend/references/performance.md similarity index 100% rename from .agents/skills/code-frontend/references/performance.md rename to src/skills/code-frontend/references/performance.md diff --git a/.agents/skills/code-frontend/references/pwa.md b/src/skills/code-frontend/references/pwa.md similarity index 100% rename from .agents/skills/code-frontend/references/pwa.md rename to src/skills/code-frontend/references/pwa.md diff --git a/.agents/skills/code-frontend/references/state.md b/src/skills/code-frontend/references/state.md similarity index 100% rename from .agents/skills/code-frontend/references/state.md rename to src/skills/code-frontend/references/state.md diff --git a/.agents/skills/code-frontend/references/typescript.md b/src/skills/code-frontend/references/typescript.md similarity index 100% rename from .agents/skills/code-frontend/references/typescript.md rename to src/skills/code-frontend/references/typescript.md diff --git a/.agents/skills/code-frontend/references/visualization.md b/src/skills/code-frontend/references/visualization.md similarity index 100% rename from .agents/skills/code-frontend/references/visualization.md rename to src/skills/code-frontend/references/visualization.md diff --git a/.agents/skills/code-tests/SKILL.md b/src/skills/code-tests/SKILL.md similarity index 100% rename from .agents/skills/code-tests/SKILL.md rename to src/skills/code-tests/SKILL.md diff --git a/.agents/skills/code-tests/references/api.md b/src/skills/code-tests/references/api.md similarity index 100% rename from .agents/skills/code-tests/references/api.md rename to src/skills/code-tests/references/api.md diff --git a/.agents/skills/code-tests/references/e2e.md b/src/skills/code-tests/references/e2e.md similarity index 100% rename from .agents/skills/code-tests/references/e2e.md rename to src/skills/code-tests/references/e2e.md diff --git a/.agents/skills/code-tests/references/perf.md b/src/skills/code-tests/references/perf.md similarity index 100% rename from .agents/skills/code-tests/references/perf.md rename to src/skills/code-tests/references/perf.md diff --git a/.agents/skills/code-tests/scripts/__init__.py b/src/skills/code-tests/scripts/__init__.py similarity index 100% rename from .agents/skills/code-tests/scripts/__init__.py rename to src/skills/code-tests/scripts/__init__.py diff --git a/.agents/skills/code-tests/scripts/agent_runner.py b/src/skills/code-tests/scripts/agent_runner.py similarity index 100% rename from .agents/skills/code-tests/scripts/agent_runner.py rename to src/skills/code-tests/scripts/agent_runner.py diff --git a/.agents/skills/code-tests/scripts/aggregate_benchmark.py b/src/skills/code-tests/scripts/aggregate_benchmark.py similarity index 100% rename from .agents/skills/code-tests/scripts/aggregate_benchmark.py rename to src/skills/code-tests/scripts/aggregate_benchmark.py diff --git a/.agents/skills/code-tests/scripts/generate_report.py b/src/skills/code-tests/scripts/generate_report.py similarity index 100% rename from .agents/skills/code-tests/scripts/generate_report.py rename to src/skills/code-tests/scripts/generate_report.py diff --git a/.agents/skills/code-tests/scripts/improve_description.py b/src/skills/code-tests/scripts/improve_description.py similarity index 100% rename from .agents/skills/code-tests/scripts/improve_description.py rename to src/skills/code-tests/scripts/improve_description.py diff --git a/.agents/skills/code-tests/scripts/run_eval.py b/src/skills/code-tests/scripts/run_eval.py similarity index 100% rename from .agents/skills/code-tests/scripts/run_eval.py rename to src/skills/code-tests/scripts/run_eval.py diff --git a/.agents/skills/code-tests/scripts/run_loop.py b/src/skills/code-tests/scripts/run_loop.py similarity index 100% rename from .agents/skills/code-tests/scripts/run_loop.py rename to src/skills/code-tests/scripts/run_loop.py diff --git a/.agents/skills/code-tests/scripts/utils.py b/src/skills/code-tests/scripts/utils.py similarity index 100% rename from .agents/skills/code-tests/scripts/utils.py rename to src/skills/code-tests/scripts/utils.py diff --git a/.agents/skills/code-tests/scripts/validate_evals.py b/src/skills/code-tests/scripts/validate_evals.py similarity index 100% rename from .agents/skills/code-tests/scripts/validate_evals.py rename to src/skills/code-tests/scripts/validate_evals.py diff --git a/.agents/skills/create-rule/SKILL.md b/src/skills/create-rule/SKILL.md similarity index 99% rename from .agents/skills/create-rule/SKILL.md rename to src/skills/create-rule/SKILL.md index 258a698..50c2532 100644 --- a/.agents/skills/create-rule/SKILL.md +++ b/src/skills/create-rule/SKILL.md @@ -1,6 +1,6 @@ --- name: create-rule -description: Use when writing or improving CLI-agent rules, custom instruction files, AGENTS.md, CLAUDE.md, Cursor rules, Copilot instructions, or modular `.agents/rules/*.md` files. +description: Use when writing or improving CLI-agent rules, custom instruction files, AGENTS.md, CLAUDE.md, Cursor rules, Copilot instructions, or modular `rules/.md` files. license: MIT tags: - creator @@ -8,7 +8,7 @@ tags: - agents metadata: author: Oleg Shulyakov - version: "1.4.0" + version: "1.4.1" source: github.com/olegshulyakov/agent.md catalog: utility category: meta diff --git a/.agents/skills/create-rule/scripts/grade_rule_output.py b/src/skills/create-rule/scripts/grade_rule_output.py similarity index 99% rename from .agents/skills/create-rule/scripts/grade_rule_output.py rename to src/skills/create-rule/scripts/grade_rule_output.py index 60f80d1..e092b15 100644 --- a/.agents/skills/create-rule/scripts/grade_rule_output.py +++ b/src/skills/create-rule/scripts/grade_rule_output.py @@ -89,7 +89,7 @@ def grade(eval_item: dict, output: str) -> dict: "All backticked prompt terms appear in output" if not missing_terms else f"Missing: {missing_terms}", ) - wants_modular = any(term in lower_prompt + lower_expected for term in [".agents/rules", "modular", "playbook-compatible"]) + wants_modular = any(term in lower_prompt + lower_expected for term in ["src/rules", "modular", "playbook-compatible"]) if wants_modular: add_check( checks, diff --git a/.agents/skills/create-rule/scripts/run_trigger_eval.py b/src/skills/create-rule/scripts/run_trigger_eval.py similarity index 99% rename from .agents/skills/create-rule/scripts/run_trigger_eval.py rename to src/skills/create-rule/scripts/run_trigger_eval.py index 24f8d33..760d4b9 100644 --- a/.agents/skills/create-rule/scripts/run_trigger_eval.py +++ b/src/skills/create-rule/scripts/run_trigger_eval.py @@ -23,7 +23,7 @@ r"\b(write|create|draft|make|improve|rewrite|turn).{0,60}\b(rule|rules|instruction|instructions)\b", r"\b(convert|add).{0,80}\b(agent|agents).{0,30}\b(rule|rules|instruction|instructions)\b", r"\b(convert|add).{0,80}\b(rule|rules|instruction|instructions).{0,30}\b(agent|agents)\b", - r"\b(AGENTS\.md|CLAUDE\.md|copilot-instructions\.md|Cursor rule|\.agents/rules|\.claude/rules)\b", + r"\b(AGENTS\.md|CLAUDE\.md|copilot-instructions\.md|Cursor rule|\src/rules|\.claude/rules)\b", r"\bpath-scoped rule\b", r"\bCLI-agent rule\b", ] diff --git a/.agents/skills/create-rule/scripts/validate_evals.py b/src/skills/create-rule/scripts/validate_evals.py similarity index 100% rename from .agents/skills/create-rule/scripts/validate_evals.py rename to src/skills/create-rule/scripts/validate_evals.py diff --git a/.agents/skills/create-rule/scripts/validate_rule.py b/src/skills/create-rule/scripts/validate_rule.py similarity index 100% rename from .agents/skills/create-rule/scripts/validate_rule.py rename to src/skills/create-rule/scripts/validate_rule.py diff --git a/.agents/skills/create-skill/SKILL.md b/src/skills/create-skill/SKILL.md similarity index 100% rename from .agents/skills/create-skill/SKILL.md rename to src/skills/create-skill/SKILL.md diff --git a/.agents/skills/create-skill/agents/analyzer.md b/src/skills/create-skill/agents/analyzer.md similarity index 100% rename from .agents/skills/create-skill/agents/analyzer.md rename to src/skills/create-skill/agents/analyzer.md diff --git a/.agents/skills/create-skill/agents/benchmark-analyzer.md b/src/skills/create-skill/agents/benchmark-analyzer.md similarity index 100% rename from .agents/skills/create-skill/agents/benchmark-analyzer.md rename to src/skills/create-skill/agents/benchmark-analyzer.md diff --git a/.agents/skills/create-skill/agents/comparator.md b/src/skills/create-skill/agents/comparator.md similarity index 100% rename from .agents/skills/create-skill/agents/comparator.md rename to src/skills/create-skill/agents/comparator.md diff --git a/.agents/skills/create-skill/agents/grader.md b/src/skills/create-skill/agents/grader.md similarity index 100% rename from .agents/skills/create-skill/agents/grader.md rename to src/skills/create-skill/agents/grader.md diff --git a/.agents/skills/create-skill/assets/eval_review.html b/src/skills/create-skill/assets/eval_review.html similarity index 100% rename from .agents/skills/create-skill/assets/eval_review.html rename to src/skills/create-skill/assets/eval_review.html diff --git a/.agents/skills/create-skill/eval-viewer/generate_review.py b/src/skills/create-skill/eval-viewer/generate_review.py similarity index 100% rename from .agents/skills/create-skill/eval-viewer/generate_review.py rename to src/skills/create-skill/eval-viewer/generate_review.py diff --git a/.agents/skills/create-skill/eval-viewer/viewer.html b/src/skills/create-skill/eval-viewer/viewer.html similarity index 100% rename from .agents/skills/create-skill/eval-viewer/viewer.html rename to src/skills/create-skill/eval-viewer/viewer.html diff --git a/.agents/skills/create-skill/evals/evals.yaml b/src/skills/create-skill/evals/evals.yaml similarity index 100% rename from .agents/skills/create-skill/evals/evals.yaml rename to src/skills/create-skill/evals/evals.yaml diff --git a/.agents/skills/create-skill/references/agent-compatibility.md b/src/skills/create-skill/references/agent-compatibility.md similarity index 100% rename from .agents/skills/create-skill/references/agent-compatibility.md rename to src/skills/create-skill/references/agent-compatibility.md diff --git a/.agents/skills/create-skill/references/authoring.md b/src/skills/create-skill/references/authoring.md similarity index 100% rename from .agents/skills/create-skill/references/authoring.md rename to src/skills/create-skill/references/authoring.md diff --git a/.agents/skills/create-skill/references/description-optimization.md b/src/skills/create-skill/references/description-optimization.md similarity index 100% rename from .agents/skills/create-skill/references/description-optimization.md rename to src/skills/create-skill/references/description-optimization.md diff --git a/.agents/skills/create-skill/references/evaluation.md b/src/skills/create-skill/references/evaluation.md similarity index 100% rename from .agents/skills/create-skill/references/evaluation.md rename to src/skills/create-skill/references/evaluation.md diff --git a/.agents/skills/create-skill/references/review.md b/src/skills/create-skill/references/review.md similarity index 100% rename from .agents/skills/create-skill/references/review.md rename to src/skills/create-skill/references/review.md diff --git a/.agents/skills/create-skill/references/schemas.md b/src/skills/create-skill/references/schemas.md similarity index 100% rename from .agents/skills/create-skill/references/schemas.md rename to src/skills/create-skill/references/schemas.md diff --git a/.agents/skills/create-skill/scripts/__init__.py b/src/skills/create-skill/scripts/__init__.py similarity index 100% rename from .agents/skills/create-skill/scripts/__init__.py rename to src/skills/create-skill/scripts/__init__.py diff --git a/.agents/skills/create-skill/scripts/agent_runner.py b/src/skills/create-skill/scripts/agent_runner.py similarity index 100% rename from .agents/skills/create-skill/scripts/agent_runner.py rename to src/skills/create-skill/scripts/agent_runner.py diff --git a/.agents/skills/create-skill/scripts/aggregate_benchmark.py b/src/skills/create-skill/scripts/aggregate_benchmark.py similarity index 100% rename from .agents/skills/create-skill/scripts/aggregate_benchmark.py rename to src/skills/create-skill/scripts/aggregate_benchmark.py diff --git a/.agents/skills/create-skill/scripts/generate_report.py b/src/skills/create-skill/scripts/generate_report.py similarity index 100% rename from .agents/skills/create-skill/scripts/generate_report.py rename to src/skills/create-skill/scripts/generate_report.py diff --git a/.agents/skills/create-skill/scripts/improve_description.py b/src/skills/create-skill/scripts/improve_description.py similarity index 100% rename from .agents/skills/create-skill/scripts/improve_description.py rename to src/skills/create-skill/scripts/improve_description.py diff --git a/.agents/skills/create-skill/scripts/package_skill.py b/src/skills/create-skill/scripts/package_skill.py similarity index 100% rename from .agents/skills/create-skill/scripts/package_skill.py rename to src/skills/create-skill/scripts/package_skill.py diff --git a/.agents/skills/create-skill/scripts/run_eval.py b/src/skills/create-skill/scripts/run_eval.py similarity index 100% rename from .agents/skills/create-skill/scripts/run_eval.py rename to src/skills/create-skill/scripts/run_eval.py diff --git a/.agents/skills/create-skill/scripts/run_loop.py b/src/skills/create-skill/scripts/run_loop.py similarity index 100% rename from .agents/skills/create-skill/scripts/run_loop.py rename to src/skills/create-skill/scripts/run_loop.py diff --git a/.agents/skills/create-skill/scripts/utils.py b/src/skills/create-skill/scripts/utils.py similarity index 100% rename from .agents/skills/create-skill/scripts/utils.py rename to src/skills/create-skill/scripts/utils.py diff --git a/.agents/skills/create-skill/scripts/validate.py b/src/skills/create-skill/scripts/validate.py similarity index 100% rename from .agents/skills/create-skill/scripts/validate.py rename to src/skills/create-skill/scripts/validate.py diff --git a/.agents/skills/design-api/SKILL.md b/src/skills/design-api/SKILL.md similarity index 100% rename from .agents/skills/design-api/SKILL.md rename to src/skills/design-api/SKILL.md diff --git a/.agents/skills/design-api/references/asyncapi.md b/src/skills/design-api/references/asyncapi.md similarity index 100% rename from .agents/skills/design-api/references/asyncapi.md rename to src/skills/design-api/references/asyncapi.md diff --git a/.agents/skills/design-api/references/graphql.md b/src/skills/design-api/references/graphql.md similarity index 100% rename from .agents/skills/design-api/references/graphql.md rename to src/skills/design-api/references/graphql.md diff --git a/.agents/skills/design-api/references/openapi.md b/src/skills/design-api/references/openapi.md similarity index 100% rename from .agents/skills/design-api/references/openapi.md rename to src/skills/design-api/references/openapi.md diff --git a/.agents/skills/explain/SKILL.md b/src/skills/explain/SKILL.md similarity index 100% rename from .agents/skills/explain/SKILL.md rename to src/skills/explain/SKILL.md diff --git a/.agents/skills/investigate/SKILL.md b/src/skills/investigate/SKILL.md similarity index 100% rename from .agents/skills/investigate/SKILL.md rename to src/skills/investigate/SKILL.md diff --git a/.agents/skills/manage-git/SKILL.md b/src/skills/manage-git/SKILL.md similarity index 100% rename from .agents/skills/manage-git/SKILL.md rename to src/skills/manage-git/SKILL.md diff --git a/.agents/skills/manage-git/references/branch-naming.md b/src/skills/manage-git/references/branch-naming.md similarity index 100% rename from .agents/skills/manage-git/references/branch-naming.md rename to src/skills/manage-git/references/branch-naming.md diff --git a/.agents/skills/manage-git/references/commit-message.md b/src/skills/manage-git/references/commit-message.md similarity index 100% rename from .agents/skills/manage-git/references/commit-message.md rename to src/skills/manage-git/references/commit-message.md diff --git a/.agents/skills/manage/SKILL.md b/src/skills/manage/SKILL.md similarity index 100% rename from .agents/skills/manage/SKILL.md rename to src/skills/manage/SKILL.md diff --git a/.agents/skills/plan/SKILL.md b/src/skills/plan/SKILL.md similarity index 100% rename from .agents/skills/plan/SKILL.md rename to src/skills/plan/SKILL.md diff --git a/.agents/skills/remember/SKILL.md b/src/skills/remember/SKILL.md similarity index 93% rename from .agents/skills/remember/SKILL.md rename to src/skills/remember/SKILL.md index a80941b..0737936 100644 --- a/.agents/skills/remember/SKILL.md +++ b/src/skills/remember/SKILL.md @@ -1,6 +1,6 @@ --- name: remember -description: Preserve durable project facts, decisions, and useful observations in .agents/memory/. Use for memory requests like "remember this", "save context", "record a decision", "update memory", or preserving a project fact. +description: Preserve durable project facts, decisions, and useful observations in memory files. Use for memory requests like "remember this", "save context", "record a decision", "update memory", or preserving a project fact. license: MIT tags: - remember @@ -8,7 +8,7 @@ tags: - project-context metadata: author: Oleg Shulyakov - version: "1.0.3" + version: "1.1.0" source: github.com/olegshulyakov/agent.md catalog: utility category: productivity diff --git a/.agents/skills/review-code/SKILL.md b/src/skills/review-code/SKILL.md similarity index 100% rename from .agents/skills/review-code/SKILL.md rename to src/skills/review-code/SKILL.md diff --git a/.agents/skills/review-code/references/checklist.md b/src/skills/review-code/references/checklist.md similarity index 100% rename from .agents/skills/review-code/references/checklist.md rename to src/skills/review-code/references/checklist.md diff --git a/.agents/skills/review-code/references/performance.md b/src/skills/review-code/references/performance.md similarity index 100% rename from .agents/skills/review-code/references/performance.md rename to src/skills/review-code/references/performance.md diff --git a/.agents/skills/review-code/references/regressions.md b/src/skills/review-code/references/regressions.md similarity index 100% rename from .agents/skills/review-code/references/regressions.md rename to src/skills/review-code/references/regressions.md diff --git a/.agents/skills/review-code/references/security.md b/src/skills/review-code/references/security.md similarity index 100% rename from .agents/skills/review-code/references/security.md rename to src/skills/review-code/references/security.md diff --git a/.agents/skills/review-code/references/test-gaps.md b/src/skills/review-code/references/test-gaps.md similarity index 100% rename from .agents/skills/review-code/references/test-gaps.md rename to src/skills/review-code/references/test-gaps.md diff --git a/.agents/skills/write-prd/SKILL.md b/src/skills/write-prd/SKILL.md similarity index 100% rename from .agents/skills/write-prd/SKILL.md rename to src/skills/write-prd/SKILL.md diff --git a/.agents/skills/write-prd/references/examples.md b/src/skills/write-prd/references/examples.md similarity index 100% rename from .agents/skills/write-prd/references/examples.md rename to src/skills/write-prd/references/examples.md diff --git a/.agents/skills/write-prd/references/output-format.md b/src/skills/write-prd/references/output-format.md similarity index 100% rename from .agents/skills/write-prd/references/output-format.md rename to src/skills/write-prd/references/output-format.md diff --git a/.agents/skills/write-spec/SKILL.md b/src/skills/write-spec/SKILL.md similarity index 100% rename from .agents/skills/write-spec/SKILL.md rename to src/skills/write-spec/SKILL.md diff --git a/.agents/skills/write-spec/references/data-contract.md b/src/skills/write-spec/references/data-contract.md similarity index 100% rename from .agents/skills/write-spec/references/data-contract.md rename to src/skills/write-spec/references/data-contract.md diff --git a/.agents/skills/write-spec/references/design-ui.md b/src/skills/write-spec/references/design-ui.md similarity index 100% rename from .agents/skills/write-spec/references/design-ui.md rename to src/skills/write-spec/references/design-ui.md diff --git a/.agents/skills/write-spec/references/functional.md b/src/skills/write-spec/references/functional.md similarity index 100% rename from .agents/skills/write-spec/references/functional.md rename to src/skills/write-spec/references/functional.md diff --git a/.agents/skills/write-spec/references/non-functional.md b/src/skills/write-spec/references/non-functional.md similarity index 100% rename from .agents/skills/write-spec/references/non-functional.md rename to src/skills/write-spec/references/non-functional.md diff --git a/.agents/skills/write-spec/references/technical.md b/src/skills/write-spec/references/technical.md similarity index 100% rename from .agents/skills/write-spec/references/technical.md rename to src/skills/write-spec/references/technical.md diff --git a/.agents/skills/write-tech-docs/SKILL.md b/src/skills/write-tech-docs/SKILL.md similarity index 100% rename from .agents/skills/write-tech-docs/SKILL.md rename to src/skills/write-tech-docs/SKILL.md diff --git a/.agents/skills/write-tech-docs/references/api-docs.md b/src/skills/write-tech-docs/references/api-docs.md similarity index 100% rename from .agents/skills/write-tech-docs/references/api-docs.md rename to src/skills/write-tech-docs/references/api-docs.md diff --git a/.agents/skills/write-tech-docs/references/changelog.md b/src/skills/write-tech-docs/references/changelog.md similarity index 100% rename from .agents/skills/write-tech-docs/references/changelog.md rename to src/skills/write-tech-docs/references/changelog.md diff --git a/.agents/skills/write-tech-docs/references/readme.md b/src/skills/write-tech-docs/references/readme.md similarity index 100% rename from .agents/skills/write-tech-docs/references/readme.md rename to src/skills/write-tech-docs/references/readme.md diff --git a/.agents/skills/write-tech-docs/references/release-notes.md b/src/skills/write-tech-docs/references/release-notes.md similarity index 100% rename from .agents/skills/write-tech-docs/references/release-notes.md rename to src/skills/write-tech-docs/references/release-notes.md diff --git a/.agents/skills/write-tech-docs/references/runbook-oncall.md b/src/skills/write-tech-docs/references/runbook-oncall.md similarity index 100% rename from .agents/skills/write-tech-docs/references/runbook-oncall.md rename to src/skills/write-tech-docs/references/runbook-oncall.md diff --git a/.agents/skills/write-tech-docs/references/runbook-routine.md b/src/skills/write-tech-docs/references/runbook-routine.md similarity index 100% rename from .agents/skills/write-tech-docs/references/runbook-routine.md rename to src/skills/write-tech-docs/references/runbook-routine.md diff --git a/.agents/skills/write-user-story/SKILL.md b/src/skills/write-user-story/SKILL.md similarity index 100% rename from .agents/skills/write-user-story/SKILL.md rename to src/skills/write-user-story/SKILL.md diff --git a/.agents/skills/write-user-story/references/ai-output-format.md b/src/skills/write-user-story/references/ai-output-format.md similarity index 100% rename from .agents/skills/write-user-story/references/ai-output-format.md rename to src/skills/write-user-story/references/ai-output-format.md diff --git a/.agents/skills/write-user-story/references/examples.md b/src/skills/write-user-story/references/examples.md similarity index 100% rename from .agents/skills/write-user-story/references/examples.md rename to src/skills/write-user-story/references/examples.md diff --git a/.agents/skills/write-user-story/references/output-format.md b/src/skills/write-user-story/references/output-format.md similarity index 100% rename from .agents/skills/write-user-story/references/output-format.md rename to src/skills/write-user-story/references/output-format.md