@igorlau/dotagents 1.0.21 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. package/README.md +65 -65
  2. package/THIRD_PARTY_NOTICES.md +101 -6
  3. package/dist/build-info.json +1 -1
  4. package/dist/catalog.js +3 -3
  5. package/dist/cli.js +1 -1
  6. package/dist/commands.js +9 -8
  7. package/dist/manifest.js +8 -1
  8. package/dist/paths.js +0 -4
  9. package/dist/targets.js +3 -9
  10. package/dist/wizard.js +1 -1
  11. package/package.json +5 -3
  12. package/{plugin/rules → rules}/comments.upstream.json +1 -1
  13. package/{plugin/rules → rules}/ponytail.md +1 -1
  14. package/{plugin/rules → rules}/ponytail.upstream.json +1 -1
  15. package/{plugin/rules → rules}/writing.md +1 -2
  16. package/{plugin/rules → rules}/writing.upstream.json +1 -1
  17. package/{plugin/scaffold → scaffold}/AGENTS.md.tmpl +1 -1
  18. package/{plugin/skills → skills}/dot-code-review/SKILL.md +2 -0
  19. package/{plugin/skills → skills}/dot-code-review/UPSTREAM.json +1 -1
  20. package/skills/dot-code-review/references/finding-classes.md +33 -0
  21. package/{plugin/skills → skills}/dot-comments/UPSTREAM.json +1 -1
  22. package/{plugin/skills → skills}/dot-commit/SKILL.md +0 -2
  23. package/skills/dot-correct/UPSTREAM.json +8 -0
  24. package/{plugin/skills → skills}/dot-debug/UPSTREAM.json +1 -1
  25. package/{plugin/skills → skills}/dot-grilling/UPSTREAM.json +2 -2
  26. package/{plugin/skills → skills}/dot-handoff/UPSTREAM.json +1 -1
  27. package/{plugin/skills → skills}/dot-implement/SKILL.md +2 -2
  28. package/{plugin/skills → skills}/dot-plan/SKILL.md +3 -1
  29. package/{plugin/skills → skills}/dot-roadmap/SKILL.md +7 -4
  30. package/skills/dot-security-audit/SKILL.md +87 -0
  31. package/skills/dot-security-audit/UPSTREAM.json +8 -0
  32. package/skills/dot-security-audit/references/AI-AND-LLM.md +83 -0
  33. package/skills/dot-security-audit/references/ATTACK-CLASSES.md +130 -0
  34. package/skills/dot-security-audit/references/CLIENT-SIDE.md +83 -0
  35. package/skills/dot-security-audit/references/CLOUD-AND-DEPLOYMENT.md +86 -0
  36. package/skills/dot-security-audit/references/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
  37. package/skills/dot-security-audit/references/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
  38. package/skills/dot-security-audit/references/MEMORY-SAFETY-AND-BINARY.md +101 -0
  39. package/skills/dot-security-audit/references/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
  40. package/skills/dot-security-audit/references/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
  41. package/skills/dot-security-audit/references/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
  42. package/skills/dot-security-audit/references/WEB-PROTOCOL-AND-AUTH.md +105 -0
  43. package/skills/dot-security-changes/SKILL.md +68 -0
  44. package/{plugin/skills → skills}/dot-testing/UPSTREAM.json +1 -1
  45. package/skills/dot-ui-review/SKILL.md +79 -0
  46. package/skills/dot-ui-review/UPSTREAM.json +8 -0
  47. package/skills/dot-ux-review/SKILL.md +50 -0
  48. package/skills/dot-ux-review/UPSTREAM.json +8 -0
  49. package/skills/dot-ux-review/references/web-interface-guidelines.md +191 -0
  50. package/{plugin/skills/dot-stack-review → skills/dot-walkthrough-branch}/SKILL.md +9 -30
  51. package/skills/dot-walkthrough-branch/references/layers.md +38 -0
  52. package/{plugin/skills/dot-stack-review → skills/dot-walkthrough-branch}/scripts/page.mjs +39 -10
  53. package/skills/dot-walkthrough-changes/SKILL.md +62 -0
  54. package/skills/dot-writing-for-agents/UPSTREAM.json +8 -0
  55. package/plugin/.claude-plugin/plugin.json +0 -10
  56. package/plugin/agents/dot-implementer.md +0 -27
  57. package/plugin/agents/dot-reviewer.md +0 -44
  58. package/plugin/agents/dot-tester.md +0 -25
  59. package/plugin/hooks/check.mjs +0 -118
  60. package/plugin/hooks/hooks.json +0 -54
  61. package/plugin/hooks/rules.mjs +0 -27
  62. package/plugin/skills/dot-correct/UPSTREAM.json +0 -8
  63. package/plugin/skills/dot-correct/agents/openai.yaml +0 -5
  64. package/plugin/skills/dot-debug/agents/openai.yaml +0 -3
  65. package/plugin/skills/dot-flow/SKILL.md +0 -105
  66. package/plugin/skills/dot-flow/agents/openai.yaml +0 -5
  67. package/plugin/skills/dot-flow/references/fix-round.md +0 -64
  68. package/plugin/skills/dot-flow/references/inline.md +0 -9
  69. package/plugin/skills/dot-grilling/agents/openai.yaml +0 -3
  70. package/plugin/skills/dot-handoff/agents/openai.yaml +0 -5
  71. package/plugin/skills/dot-roadmap/agents/openai.yaml +0 -5
  72. package/plugin/skills/dot-stack-review/agents/openai.yaml +0 -5
  73. package/plugin/skills/dot-writing-for-agents/UPSTREAM.json +0 -8
  74. package/plugin/skills/dot-writing-for-agents/agents/openai.yaml +0 -3
  75. /package/{plugin/rules → rules}/code-style.md +0 -0
  76. /package/{plugin/rules → rules}/comments.md +0 -0
  77. /package/{plugin/rules → rules}/core.md +0 -0
  78. /package/{plugin/scaffold → scaffold}/.claude/settings.json.tmpl +0 -0
  79. /package/{plugin/scaffold → scaffold}/.editorconfig.tmpl +0 -0
  80. /package/{plugin/scaffold → scaffold}/.gitattributes.tmpl +0 -0
  81. /package/{plugin/scaffold → scaffold}/CLAUDE.md.tmpl +0 -0
  82. /package/{plugin/skills → skills}/dot-code-review/references/maintainability.md +0 -0
  83. /package/{plugin/skills → skills}/dot-comments/SKILL.md +0 -0
  84. /package/{plugin/skills → skills}/dot-correct/SKILL.md +0 -0
  85. /package/{plugin/skills → skills}/dot-debug/SKILL.md +0 -0
  86. /package/{plugin/skills → skills}/dot-debug/references/loops.md +0 -0
  87. /package/{plugin/skills → skills}/dot-debug/scripts/hitl-loop.template.sh +0 -0
  88. /package/{plugin/skills → skills}/dot-docs-writing/SKILL.md +0 -0
  89. /package/{plugin/skills → skills}/dot-docs-writing/references/formatting.md +0 -0
  90. /package/{plugin/skills → skills}/dot-docs-writing/references/global-and-accessible.md +0 -0
  91. /package/{plugin/skills → skills}/dot-docs-writing/references/word-list.md +0 -0
  92. /package/{plugin/skills → skills}/dot-grilling/SKILL.md +0 -0
  93. /package/{plugin/skills → skills}/dot-handoff/SKILL.md +0 -0
  94. /package/{plugin/skills → skills}/dot-implement/UPSTREAM.json +0 -0
  95. /package/{plugin/skills → skills}/dot-implement/references/typescript.md +0 -0
  96. /package/{plugin/skills → skills}/dot-plan/UPSTREAM.json +0 -0
  97. /package/{plugin/skills → skills}/dot-plan/references/entity-schemas.md +0 -0
  98. /package/{plugin/skills → skills}/dot-roadmap/UPSTREAM.json +0 -0
  99. /package/{plugin/skills → skills}/dot-roadmap/references/wide-refactor.md +0 -0
  100. /package/{plugin/skills → skills}/dot-testing/SKILL.md +0 -0
  101. /package/{plugin/skills → skills}/dot-testing/references/after-implement.md +0 -0
  102. /package/{plugin/skills → skills}/dot-testing/references/http.md +0 -0
  103. /package/{plugin/skills → skills}/dot-testing/references/shared-state.md +0 -0
  104. /package/{plugin/skills → skills}/dot-testing/references/typescript.md +0 -0
  105. /package/{plugin/skills → skills}/dot-writing-for-agents/SKILL.md +0 -0
  106. /package/{plugin/skills → skills}/dot-writing-for-agents/references/pointers.md +0 -0
  107. /package/{plugin/skills → skills}/dot-writing-for-agents/references/skill-mechanics.md +0 -0
  108. /package/{plugin/skills → skills}/dot-writing-for-agents/references/steps.md +0 -0
@@ -1,64 +0,0 @@
1
- # Fix round
2
-
3
- Read this file in the [`dot-flow`](../SKILL.md) skill before the first fix round, automatic or picked by the user. Read its "Snapshots" section earlier, when the first review of the task ends. The file gives the snapshots, the light path, the choice between a full review and a delta review, and the fields of step 3 on a fix run. Both runners use it.
4
-
5
- ## Snapshots
6
-
7
- A snapshot is a Git tree of the working tree, with the untracked files and without the ignored files. Write it with a temporary index, so that the working tree and the index stay as they are. Run these commands at the repository root:
8
-
9
- ```bash
10
- tmp="$(mktemp)"
11
- cp "$(git rev-parse --git-path index)" "$tmp"
12
- GIT_INDEX_FILE="$tmp" git add -A && GIT_INDEX_FILE="$tmp" git write-tree
13
- rm -f "$tmp"
14
- ```
15
-
16
- `git write-tree` prints the hash of the tree. When the commands print no hash, stop the flow and show the error to the user. Each fix round uses 2 trees:
17
-
18
- - **Old tree**: the state that the last review read. Before the first fix round, write it when the first review reply arrives, before you show the review to the user. On a later fix round, it is the new tree of the round before.
19
- - **New tree**: write it after step 2 of the fix round is verified, before step 3 starts.
20
-
21
- Compare the 2 trees, not a tree and the working tree. `git diff <tree>` misses the new untracked files, and shows the files that were untracked at the snapshot as deleted.
22
-
23
- Compare the paths from the repository root, as `git diff --name-only` prints them. Before a comparison, remove the repository root from each absolute path in a finding or on a **Files** line.
24
-
25
- ## Light path
26
-
27
- The light path applies when the user picks Fix and every finding to fix is `low`. A light-fixed finding is a finding that the light path fixed since the last review. On this path, the reply of step 1 ends with the line `**Behavior change:** <yes | no>`. After step 1, write a tree as the "Snapshots" section gives it, and check these 3 conditions:
28
-
29
- - The **Behavior change** line says `no`.
30
- - `git diff --name-only <old-tree> <tree>` lists only files that the findings to fix or the light-fixed findings name.
31
- - The checks of the reply and the full test command pass, with no failed test.
32
-
33
- When all 3 are true, skip steps 2 and 3. Add a `light` row to the round history, and show the stop of `SKILL.md` step 4 again, with each fixed finding as "fixed, not reviewed". Keep the old tree, so that the next review also reads the light fix. Add the light-fixed findings to the **Earlier findings** of the next review, so that it grades them.
34
-
35
- When a condition is false, run steps 2 and 3 as a normal fix round.
36
-
37
- ## Full or delta
38
-
39
- Run `git diff --name-only <old-tree> <new-tree>`, and read only the file names, never the changed files. Remove from the list the files on the **Files** line of the step 2 reply of the round. The delta diff still has these test changes, so a delta review reviews them.
40
-
41
- - When the list that remains has a file that no earlier finding names, run a full review: leave out **Since**.
42
- - Otherwise, run a delta review: give step 3 the **Since** field.
43
-
44
- ## Fields of step 3
45
-
46
- On a fix run, add these fields after **Handoff**:
47
-
48
- ```markdown
49
- **Since:** <old-tree> <new-tree>
50
- **Earlier findings:**
51
- <the findings that the round sent to fix and the light-fixed findings, unchanged>
52
- ```
53
-
54
- - **Since**: only on a delta review. The reviewer runs `git diff <old-tree> <new-tree>`, and reviews only that diff. It still checks the diff against every `NN` and each `BR` that the task names. A delta review does not find an old defect that an earlier review missed. This trade-off is accepted.
55
- - **Earlier findings**: on each fix run, full or delta. The reviewer does not report an earlier finding again as a new finding. It gives each earlier finding one status, and reports the statuses before the new findings:
56
- - `fixed`: the problem is gone.
57
- - `open`: the problem is still there.
58
- - `regressed`: the fix made the problem worse, or moved it to other code.
59
-
60
- Only the round 1 review reports `low` findings. A review with **Earlier findings**, full or delta, reports only new `high` and `medium` findings, plus the status of each earlier finding.
61
-
62
- **Earlier findings** lists only the findings that the round sent to fix and the light-fixed findings. Keep each earlier finding that the review grades `open` or `regressed` as the last review that reported it gave it, with its `file:line` and **Fix** line. Show it again at the next decision with its status. This applies after a full review and after a delta review.
63
-
64
- Also keep each finding that remained before the round and that is not in **Earlier findings**, unchanged, and show it again at the next decision. No reviewer grades it again. After a full review, keep only the `low` ones. The report replaces the carried `high` and `medium` findings, and a later review does not report a `low` finding again. The highest severity that you show also covers the carried findings.
@@ -1,9 +0,0 @@
1
- # Inline mode
2
-
3
- Inline steps for the [`dot-flow`](../SKILL.md) skill, for an agent that cannot start the dotagents agents, such as Codex or Copilot. The verification, the stops of step 3, and step 4 stay as `SKILL.md` gives them: the automatic rounds, their limit, and the stop rules. You run each step yourself, in this conversation, instead of in an agent.
4
-
5
- 1. Implement: use the `dot-implement` skill for the task, and end the step with its handoff. Write no tests in this step. On a fix run, end the handoff with the line `**Behavior change:** <yes | no>`. A behavior change is a change to what the code does for any input. Then take the light path or run steps 2 and 3, as [`fix-round.md`](fix-round.md#light-path) gives it.
6
- 2. Test: use the `dot-testing` skill with its `references/after-implement.md` and the handoff of step 1, and end the step with the reply that the reference gives.
7
- 3. Review: use the `dot-code-review` skill for the task. Start the report with the line `**Highest severity:** <high | medium | low | none>`. Also read the `## Requirements` section of the roadmap `README.md`, check the change against every non-negotiable (`NN`) and each business rule (`BR`) that the task names, and report a breached `NN` as a `high` finding. On a fix run, write the new tree, pick a full or a delta review, and grade the earlier findings, as [`fix-round.md`](fix-round.md) gives it. On a delta review, the target is `git diff <old-tree> <new-tree>`. A full review has the target `git diff HEAD`, plus the untracked files that `git status --short` lists. The round 1 review reports every finding at every severity. A later review reports only new `high` and `medium` findings, plus the status of each earlier finding. Keep the code as it is. Delete each test that you write to prove a finding.
8
-
9
- Do only the work of the current step, even when the next step looks small. After steps 1 and 2, run the commands of the reply again before you start the next step: the verification of `SKILL.md` applies to your own replies too. The steps share one context, so read only what the current step needs.
@@ -1,3 +0,0 @@
1
- interface:
2
- display_name: "Grilling"
3
- short_description: "Stress-test a plan, one round of questions at a time"
@@ -1,5 +0,0 @@
1
- interface:
2
- display_name: "Handoff"
3
- short_description: "Compact a conversation into a handoff"
4
- policy:
5
- allow_implicit_invocation: false
@@ -1,5 +0,0 @@
1
- interface:
2
- display_name: "Roadmap"
3
- short_description: "Split a plan into phases and self-contained tasks"
4
- policy:
5
- allow_implicit_invocation: false
@@ -1,5 +0,0 @@
1
- interface:
2
- display_name: "Stack Review"
3
- short_description: "Review a branch as an ordered stack of layers"
4
- policy:
5
- allow_implicit_invocation: false
@@ -1,8 +0,0 @@
1
- {
2
- "repository": "https://github.com/mattpocock/skills",
3
- "path": "skills/productivity/writing-for-agents",
4
- "commit": "49dd158d1076134a641b33efb035946536778336",
5
- "license": "MIT",
6
- "modified": true,
7
- "notes": "Added a sentence about the conventions of the repository. Renamed with the dot- prefix. Rewrote the text under plugin/rules/writing.md. Moved SKILL-MECHANICS.md to references/skill-mechanics.md, and moved the context pointers, the two loads, and the splits to references/pointers.md, and the completion criteria to references/steps.md."
8
- }
@@ -1,3 +0,0 @@
1
- interface:
2
- display_name: "Writing for Agents"
3
- short_description: "Write documents agents consume"
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes