agentharnesses-cli 0.1.2__tar.gz → 0.1.3__tar.gz

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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agentharnesses-cli
3
- Version: 0.1.2
3
+ Version: 0.1.3
4
4
  Summary: CLI tools for agentharnesses.io
5
5
  Project-URL: Homepage, https://agentharnesses.io
6
6
  Project-URL: Repository, https://github.com/agentharnesses/cli
@@ -14,39 +14,25 @@ _MAINTAIN_SKILLS_INDEX_DEST = "skills/maintenance/SKILLS.md"
14
14
  _MAINTAIN_SKILL = """\
15
15
  ---
16
16
  name: modify-harness
17
- description: Use when asked to maintain, update, or extend this harness updating HARNESS.md, adding skills and references, managing the skill index.
17
+ description: Update harness structure files HARNESS.md, SKILLS.md indexes, REFERENCES.mdto keep routing and descriptions accurate as the harness evolves.
18
18
  ---
19
19
 
20
- ## Maintaining the Harness
20
+ ## Role
21
21
 
22
- When asked to maintain, update, or extend this harness, follow these conventions.
22
+ Keep the harness self-consistent when skills or references are added, renamed, or removed.
23
23
 
24
- When **maintaining the harness** (adding, moving, or renaming files), use `reverse_disclose.py` to find every `.md` file above the target that links to it — so you can update all references that would break:
24
+ ## What to do
25
25
 
26
- ```
27
- python3 .claude/skills/agent-harnesses/scripts/reverse_disclose.py <target_path>
28
- ```
26
+ 1. Use reverse progressive disclosure (via the `agent-harnesses` skill) to find which index files reference the target path
27
+ 2. Read the current state of each affected file
28
+ 3. Apply the change: add, update, or remove the relevant entry
29
+ 4. Ensure descriptions remain accurate and routing summaries reflect actual contents
29
30
 
30
- Run this before and after any structural change. The output lists each ancestor `.md` file that references the target, with line numbers and link text, so nothing is left pointing to a stale path.
31
+ ## Conventions
31
32
 
32
- ### HARNESS.md
33
- - Keep the `## Skills` section in sync with entries in `skills/SKILLS.md`
34
- - Keep the `## References` section in sync with entries in `references/REFERENCES.md`
35
- - Update the `description` frontmatter field when the harness scope changes
36
-
37
- ### Adding a skill bucket
38
- 1. Create `skills/<bucket-name>/<skill-name>/SKILL.md` with a frontmatter `name` and `description`
39
- 2. Add an entry to `skills/<bucket-name>/SKILLS.md` summarizing when to use the skill
40
- 3. Ensure `skills/SKILLS.md` references the bucket
41
- 4. Add a bullet to the `## Skills` section in `HARNESS.md`
42
-
43
- ### Adding a reference document
44
- 1. Add the document to `references/`
45
- 2. Add an entry to `references/REFERENCES.md` describing the document's purpose
46
- 3. Add a bullet to the `## References` section in `HARNESS.md`
47
-
48
- ### General conventions
49
- - Keep skill descriptions actionable: "Use when..." not "This skill..."
33
+ - Keep `HARNESS.md` `## Skills` and `## References` sections in sync with `skills/SKILLS.md` and `references/REFERENCES.md`
34
+ - Update the `description` frontmatter in `HARNESS.md` when the harness scope changes
35
+ - Skill descriptions should be actionable: "Use when..." not "This skill..."
50
36
  - Reference documents should be stable facts; skill buckets contain executable guidance
51
37
  - Prefer updating existing skill buckets over creating new ones when scope overlaps
52
38
  """
@@ -81,17 +67,9 @@ TODO: write the entry message Claude should internalize when this harness loads.
81
67
 
82
68
  ## How to Find Information for Claude
83
69
 
84
- Use the `agent-harnesses` skill to explore the harness, just in time, based on prompts from the user. Run `disclose.py` with `python3` against this harness directory to progressively explore its contents — select only what is relevant and repeat until the session is complete, then read the returned resources.
85
-
86
- Do not load skills or references speculatively. Use `disclose.py` to find resources when necessary. Any time you need to find anything in the harness, and you don't already know where it exists, use `disclose.py`.
87
-
88
- When **maintaining the harness** (adding, moving, or renaming files), use `reverse_disclose.py` to find every `.md` file above the target that links to it — so you can update all references that would break:
89
-
90
- ```
91
- python3 .claude/skills/agent-harnesses/scripts/reverse_disclose.py <target_path>
92
- ```
70
+ Use the `agent-harnesses` skill to explore the harness just in time, based on prompts from the user. Select only what is relevant and repeat until the session is complete, then read the returned resources.
93
71
 
94
- Run this before and after any structural change. The output lists each ancestor `.md` file that references the target, with line numbers and link text, so nothing is left pointing to a stale path.
72
+ When **maintaining the harness** (adding, moving, or renaming files), consult the `agent-harnesses` skill for reverse progressive disclosure to keep routing files in sync.
95
73
 
96
74
  ## Skills
97
75