harness-everything 0.2.2 → 0.4.0

package/repo-docs/templates/knowledge-readme-template.md

@@ -1,83 +1,83 @@
----
-name: "knowledge-readme-template"
-description: "Dynamic README template for documentation, knowledge bases, and courseware. Uses conditional {{IF feature}} blocks based on detected repository capabilities (e.g., learning paths, agentic workspaces)."
----
-
-# {Project Name}
-
-> {One-line description summarizing the core subject or purpose of this knowledge base.}
-
-<!-- Optional: badges for version, license, or status -->
-[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
-
-## Overview & Scope
-
-{2–4 sentences explaining what this repository covers, who it is for, and how the information is structured. Be specific about the domain (e.g., "This repository contains the architectural analysis of OpenClaw...").}
-
----
-
-{{IF has_learning_path}}
-## Start Here / Learning Path
-
-{Provide a brief guide on how a reader should navigate this repository based on the detected `roadmap.md`, `study-guide.md`, or sequential file naming.}
-
-- **[Step 1 Title](./path/to/file.md)**: {Brief description}
-- **[Step 2 Title](./path/to/file.md)**: {Brief description}
-{{ENDIF}}
-
----
-
-## Knowledge Directory
-
-{Organize the discovered markdown directories into thematic groups. Do not just print a raw file tree. Group them logically.}
-
-### 📂 {Thematic Group 1: e.g., Core Subsystems}
-{1 sentence describing what's in this group.}
-- [`{dir_name}/`](./path/) - {Brief description based on contents}
-- [`{dir_name}/`](./path/) - {Brief description based on contents}
-
-### 📚 {Thematic Group 2: e.g., Reference Materials}
-{1 sentence describing what's in this group.}
-- [`{dir_name}/`](./path/) - {Brief description}
-
----
-
-{{IF is_agentic_workspace}}
-## AI Agent Workspace
-
-This repository is an **Agentic Workspace**. It is actively managed and interacted with by AI agents, not just human readers.
-
-### Active Agents
-{List the detected agents from `.github/agents/` or `AGENTS.md`.}
-- **`{Agent Name}`**: {Briefly describe what this agent does based on its file name/content.}
-
-### Agent Workflows
-{Briefly explain how humans interact with the agents in this repo. E.g., "Add a task to `tasks/backlog.json` and the Orchestrator will assign it to a sub-agent. Check `logs/` for execution results."}
-{{ENDIF}}
-
----
-
-{{IF has_task_tracking}}
-## Project Status & Tasks
-
-{Describe how progress is tracked in this repository based on `STATUS.md`, `tasks/`, or backlog files.}
-
-- **Current Status**: {Extract key point from STATUS.md if available, else omit}
-- **Task Board**: Found in [`tasks/`](./tasks/).
-{{ENDIF}}
-
----
-
-{{PRESERVED_HUMAN_CONTENT}}
-<!-- AI AGENT INSTRUCTION: If the original README contained domain-specific teaching materials, tutorials, long-form explanations, or extensive deep-dive sections (e.g., "Performance vs Scalability", "System Architecture", etc.), they MUST be preserved here. Do not discard instructional prose! -->
-
----
-
-## Contributing
-
-Want to contribute to this knowledge base?
-{If `is_agentic_workspace` is true, remind users to check `AGENTS.md` before making massive structural changes. If false, just provide a standard PR message.}
-
-## License
-
-{License name} — see [LICENSE](LICENSE) for details.
+---
+name: "knowledge-readme-template"
+description: "Dynamic README template for documentation, knowledge bases, and courseware. Uses conditional {{IF feature}} blocks based on detected repository capabilities (e.g., learning paths, agentic workspaces)."
+---
+
+# {Project Name}
+
+> {One-line description summarizing the core subject or purpose of this knowledge base.}
+
+<!-- Optional: badges for version, license, or status -->
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
+
+## Overview & Scope
+
+{2–4 sentences explaining what this repository covers, who it is for, and how the information is structured. Be specific about the domain (e.g., "This repository contains the architectural analysis of OpenClaw...").}
+
+---
+
+{{IF has_learning_path}}
+## Start Here / Learning Path
+
+{Provide a brief guide on how a reader should navigate this repository based on the detected `roadmap.md`, `study-guide.md`, or sequential file naming.}
+
+- **[Step 1 Title](./path/to/file.md)**: {Brief description}
+- **[Step 2 Title](./path/to/file.md)**: {Brief description}
+{{ENDIF}}
+
+---
+
+## Knowledge Directory
+
+{Organize the discovered markdown directories into thematic groups. Do not just print a raw file tree. Group them logically.}
+
+### 📂 {Thematic Group 1: e.g., Core Subsystems}
+{1 sentence describing what's in this group.}
+- [`{dir_name}/`](./path/) - {Brief description based on contents}
+- [`{dir_name}/`](./path/) - {Brief description based on contents}
+
+### 📚 {Thematic Group 2: e.g., Reference Materials}
+{1 sentence describing what's in this group.}
+- [`{dir_name}/`](./path/) - {Brief description}
+
+---
+
+{{IF is_agentic_workspace}}
+## AI Agent Workspace
+
+This repository is an **Agentic Workspace**. It is actively managed and interacted with by AI agents, not just human readers.
+
+### Active Agents
+{List the detected agents from `.github/agents/` or `AGENTS.md`.}
+- **`{Agent Name}`**: {Briefly describe what this agent does based on its file name/content.}
+
+### Agent Workflows
+{Briefly explain how humans interact with the agents in this repo. E.g., "Add a task to `tasks/backlog.json` and the Orchestrator will assign it to a sub-agent. Check `logs/` for execution results."}
+{{ENDIF}}
+
+---
+
+{{IF has_task_tracking}}
+## Project Status & Tasks
+
+{Describe how progress is tracked in this repository based on `STATUS.md`, `tasks/`, or backlog files.}
+
+- **Current Status**: {Extract key point from STATUS.md if available, else omit}
+- **Task Board**: Found in [`tasks/`](./tasks/).
+{{ENDIF}}
+
+---
+
+{{PRESERVED_HUMAN_CONTENT}}
+<!-- AI AGENT INSTRUCTION: If the original README contained domain-specific teaching materials, tutorials, long-form explanations, or extensive deep-dive sections (e.g., "Performance vs Scalability", "System Architecture", etc.), they MUST be preserved here. Do not discard instructional prose! -->
+
+---
+
+## Contributing
+
+Want to contribute to this knowledge base?
+{If `is_agentic_workspace` is true, remind users to check `AGENTS.md` before making massive structural changes. If false, just provide a standard PR message.}
+
+## License
+
+{License name} — see [LICENSE](LICENSE) for details.

package/repo-docs/templates/manual-recon.md

@@ -1,117 +1,117 @@
----
-name: "manual-recon"
-description: "Bash commands for manual repository reconnaissance when python scripts are unavailable."
----
-
-# Manual Recon Steps
-
-Use these bash commands when `recon.py` is not available.
-Run each block and collect the output before generating docs.
-
-## 1. Directory tree
-
-```bash
-# macOS / Linux (depth 3, ignoring noise)
-find . -maxdepth 3 \
-  -not -path '*/node_modules/*' \
-  -not -path '*/.git/*' \
-  -not -path '*/__pycache__/*' \
-  -not -path '*/.venv/*' \
-  -not -path '*/dist/*' \
-  -not -path '*/build/*' \
-  -not -path '*/.next/*' \
-  -not -path '*/target/*' \
-  | sort
-```
-
-## 2. Project identity
-
-```bash
-# Node
-cat package.json | python3 -c "
-import json,sys; d=json.load(sys.stdin)
-print('name:', d.get('name'))
-print('description:', d.get('description'))
-print('version:', d.get('version'))
-print('license:', d.get('license'))
-print('scripts:', list(d.get('scripts',{}).keys()))
-print('engines:', d.get('engines'))
-"
-
-# Python
-cat pyproject.toml 2>/dev/null || cat setup.py 2>/dev/null
-
-# Rust
-cat Cargo.toml 2>/dev/null
-
-# Go
-cat go.mod 2>/dev/null
-```
-
-## 3. Package manager
-
-```bash
-ls package-lock.json yarn.lock pnpm-lock.yaml bun.lockb 2>/dev/null
-```
-
-## 4. Scripts / Makefile
-
-```bash
-# Node scripts
-cat package.json | python3 -c "
-import json,sys; d=json.load(sys.stdin)
-for k,v in d.get('scripts',{}).items(): print(f'  {k}: {v}')
-"
-
-# Makefile targets
-grep -E '^[a-zA-Z_-]+:' Makefile 2>/dev/null | head -30
-```
-
-## 5. Runtime versions
-
-```bash
-cat .nvmrc 2>/dev/null
-cat .node-version 2>/dev/null
-cat .python-version 2>/dev/null
-cat .tool-versions 2>/dev/null
-```
-
-## 6. CI commands
-
-```bash
-grep -h "run:" .github/workflows/*.yml 2>/dev/null | head -30
-```
-
-## 7. Existing docs
-
-```bash
-cat README.md 2>/dev/null
-cat AGENTS.md 2>/dev/null
-```
-
-## 8. Key config files (check presence)
-
-```bash
-ls \
-  jest.config.* vitest.config.* \
-  .eslintrc* eslint.config.* \
-  .prettierrc* prettier.config.* \
-  ruff.toml .ruff.toml \
-  turbo.json nx.json pnpm-workspace.yaml \
-  Dockerfile docker-compose.yml \
-  2>/dev/null
-```
-
-## 9. Dependency hints (detect framework)
-
-```bash
-# Node — check for common frameworks
-cat package.json | python3 -c "
-import json,sys; d=json.load(sys.stdin)
-all_deps = {**d.get('dependencies',{}), **d.get('devDependencies',{})}
-frameworks = ['next','nuxt','remix','astro','vite','express','fastify','nestjs',
-              'react','vue','svelte','solid','angular','electron','tauri']
-found = [f for f in frameworks if f in all_deps or f+'js' in all_deps]
-print('detected frameworks:', found)
-"
-```
+---
+name: "manual-recon"
+description: "Bash commands for manual repository reconnaissance when python scripts are unavailable."
+---
+
+# Manual Recon Steps
+
+Use these bash commands when `recon.py` is not available.
+Run each block and collect the output before generating docs.
+
+## 1. Directory tree
+
+```bash
+# macOS / Linux (depth 3, ignoring noise)
+find . -maxdepth 3 \
+  -not -path '*/node_modules/*' \
+  -not -path '*/.git/*' \
+  -not -path '*/__pycache__/*' \
+  -not -path '*/.venv/*' \
+  -not -path '*/dist/*' \
+  -not -path '*/build/*' \
+  -not -path '*/.next/*' \
+  -not -path '*/target/*' \
+  | sort
+```
+
+## 2. Project identity
+
+```bash
+# Node
+cat package.json | python3 -c "
+import json,sys; d=json.load(sys.stdin)
+print('name:', d.get('name'))
+print('description:', d.get('description'))
+print('version:', d.get('version'))
+print('license:', d.get('license'))
+print('scripts:', list(d.get('scripts',{}).keys()))
+print('engines:', d.get('engines'))
+"
+
+# Python
+cat pyproject.toml 2>/dev/null || cat setup.py 2>/dev/null
+
+# Rust
+cat Cargo.toml 2>/dev/null
+
+# Go
+cat go.mod 2>/dev/null
+```
+
+## 3. Package manager
+
+```bash
+ls package-lock.json yarn.lock pnpm-lock.yaml bun.lockb 2>/dev/null
+```
+
+## 4. Scripts / Makefile
+
+```bash
+# Node scripts
+cat package.json | python3 -c "
+import json,sys; d=json.load(sys.stdin)
+for k,v in d.get('scripts',{}).items(): print(f'  {k}: {v}')
+"
+
+# Makefile targets
+grep -E '^[a-zA-Z_-]+:' Makefile 2>/dev/null | head -30
+```
+
+## 5. Runtime versions
+
+```bash
+cat .nvmrc 2>/dev/null
+cat .node-version 2>/dev/null
+cat .python-version 2>/dev/null
+cat .tool-versions 2>/dev/null
+```
+
+## 6. CI commands
+
+```bash
+grep -h "run:" .github/workflows/*.yml 2>/dev/null | head -30
+```
+
+## 7. Existing docs
+
+```bash
+cat README.md 2>/dev/null
+cat AGENTS.md 2>/dev/null
+```
+
+## 8. Key config files (check presence)
+
+```bash
+ls \
+  jest.config.* vitest.config.* \
+  .eslintrc* eslint.config.* \
+  .prettierrc* prettier.config.* \
+  ruff.toml .ruff.toml \
+  turbo.json nx.json pnpm-workspace.yaml \
+  Dockerfile docker-compose.yml \
+  2>/dev/null
+```
+
+## 9. Dependency hints (detect framework)
+
+```bash
+# Node — check for common frameworks
+cat package.json | python3 -c "
+import json,sys; d=json.load(sys.stdin)
+all_deps = {**d.get('dependencies',{}), **d.get('devDependencies',{})}
+frameworks = ['next','nuxt','remix','astro','vite','express','fastify','nestjs',
+              'react','vue','svelte','solid','angular','electron','tauri']
+found = [f for f in frameworks if f in all_deps or f+'js' in all_deps]
+print('detected frameworks:', found)
+"
+```

package/repo-docs/templates/multi-skills-readme-template.md

@@ -1,72 +1,72 @@
----
-name: "multi-skills-readme-template"
-description: "README template for a repository hosting a collection of AI skills. Focuses on design philosophy, quickstart, and categorized skills with workflow dependencies."
----
-
-# {Project Name / Skill Collection}
-
-> {One-line pitch: E.g., A collection of composable, engineering-focused AI skills.}
-
-<!-- Optional: Badges for version, license, status -->
-[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
-
-## Overview & Philosophy
-
-{2–3 paragraphs explaining *why* this collection exists. What common AI coding failures (e.g., verbosity, architectural rot, misalignment) does this pack solve? Explain the design principles behind these skills.}
-
----
-
-## Quickstart
-
-{How to install or activate the entire pack of skills in the user's environment. E.g., `npx skills@latest add ...` or cloning the repo.}
-
-```bash
-{installation command}
-```
-
----
-
-## Core Problem Statements & Solutions
-
-{Identify 2-3 common failure modes when working with AI, and highlight which skills in this repository solve them.}
-
-### Problem: {e.g., The Agent Didn't Do What I Want}
-**The Fix**: Use `/{skill-name}` to {briefly describe the solution workflow}.
-
----
-
-## Skills Directory
-
-{List the skills grouped by their categories. For each category, emphasize workflow dependencies or sequential requirements.}
-
-### {Category 1: e.g., Engineering}
-
-{1-2 sentences summarizing what this category of skills does.}
-
-> **Workflow & Dependencies**:
-> - **Required Setup**: {e.g., Run `/setup-project` before using any other skills in this category.}
-> - **Suggested Flow**: {e.g., Use `/to-prd` to design -> `/to-issues` to split tasks -> `/tdd` to implement.}
-
-| Skill | Description | Link |
-|---|---|---|
-| `{skill-name}` | {Description from YAML frontmatter} | [View Skill](./skills/category/{skill-name}/SKILL.md) |
-| `{skill-name-2}` | {Description from YAML frontmatter} | [View Skill](./skills/category/{skill-name-2}/SKILL.md) |
-
-### {Category 2: e.g., Productivity}
-
-{1-2 sentences summarizing what this category of skills does.}
-
-| Skill | Description | Link |
-|---|---|---|
-| `{skill-name}` | {Description from YAML frontmatter} | [View Skill](./skills/category/{skill-name}/SKILL.md) |
-
----
-
-## Contributing & Authoring
-
-Want to add a new skill to this repository? 
-{Provide brief instructions or link to a `/write-a-skill` guideline.}
-
-## License
-
-Apache 2.0 — see [LICENSE](LICENSE) for details.
+---
+name: "multi-skills-readme-template"
+description: "README template for a repository hosting a collection of AI skills. Focuses on design philosophy, quickstart, and categorized skills with workflow dependencies."
+---
+
+# {Project Name / Skill Collection}
+
+> {One-line pitch: E.g., A collection of composable, engineering-focused AI skills.}
+
+<!-- Optional: Badges for version, license, status -->
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
+
+## Overview & Philosophy
+
+{2–3 paragraphs explaining *why* this collection exists. What common AI coding failures (e.g., verbosity, architectural rot, misalignment) does this pack solve? Explain the design principles behind these skills.}
+
+---
+
+## Quickstart
+
+{How to install or activate the entire pack of skills in the user's environment. E.g., `npx skills@latest add ...` or cloning the repo.}
+
+```bash
+{installation command}
+```
+
+---
+
+## Core Problem Statements & Solutions
+
+{Identify 2-3 common failure modes when working with AI, and highlight which skills in this repository solve them.}
+
+### Problem: {e.g., The Agent Didn't Do What I Want}
+**The Fix**: Use `/{skill-name}` to {briefly describe the solution workflow}.
+
+---
+
+## Skills Directory
+
+{List the skills grouped by their categories. For each category, emphasize workflow dependencies or sequential requirements.}
+
+### {Category 1: e.g., Engineering}
+
+{1-2 sentences summarizing what this category of skills does.}
+
+> **Workflow & Dependencies**:
+> - **Required Setup**: {e.g., Run `/setup-project` before using any other skills in this category.}
+> - **Suggested Flow**: {e.g., Use `/to-prd` to design -> `/to-issues` to split tasks -> `/tdd` to implement.}
+
+| Skill | Description | Link |
+|---|---|---|
+| `{skill-name}` | {Description from YAML frontmatter} | [View Skill](./skills/category/{skill-name}/SKILL.md) |
+| `{skill-name-2}` | {Description from YAML frontmatter} | [View Skill](./skills/category/{skill-name-2}/SKILL.md) |
+
+### {Category 2: e.g., Productivity}
+
+{1-2 sentences summarizing what this category of skills does.}
+
+| Skill | Description | Link |
+|---|---|---|
+| `{skill-name}` | {Description from YAML frontmatter} | [View Skill](./skills/category/{skill-name}/SKILL.md) |
+
+---
+
+## Contributing & Authoring
+
+Want to add a new skill to this repository? 
+{Provide brief instructions or link to a `/write-a-skill` guideline.}
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE) for details.