@dotdotgod/hermes 0.0.0-stage → 0.6.0

package/skills/project-initializer/templates/research.json

@@ -0,0 +1,292 @@
+{
+  "documentation": {
+    "root": "docs"
+  },
+  "memory": {
+    "areas": [
+      {
+        "id": "rules",
+        "label": "Agent Rules",
+        "paths": [
+          "AGENTS.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-working-rules",
+        "priority": 100,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "agent-entrypoint",
+        "label": "Agent Entrypoints",
+        "paths": [
+          "CLAUDE.md",
+          "CODEX.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-specific-entrypoint",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "project-overview",
+        "label": "Project Overview",
+        "paths": [
+          "README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-map",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "docs-index",
+        "label": "Docs Index",
+        "paths": [
+          "docs/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "documentation-routing-map",
+        "priority": 90,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "spec",
+        "label": "Research Specifications",
+        "paths": [
+          "docs/spec/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "research-contract",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "architecture",
+        "label": "Architecture",
+        "paths": [
+          "docs/arch/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "architecture-rationale",
+        "priority": 82,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "test",
+        "label": "Verification",
+        "paths": [
+          "docs/test/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "test-strategy",
+        "priority": 78,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "research",
+        "label": "Research Notes",
+        "paths": [
+          "docs/research/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "research-diary",
+        "priority": 70,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "record",
+        "label": "Research Records",
+        "paths": [
+          "docs/record/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "research-record",
+        "priority": 68,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "report",
+        "label": "Reports",
+        "paths": [
+          "docs/report/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "stale",
+        "role": "report-background",
+        "priority": 60,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "artifacts",
+        "label": "Generated Artifacts",
+        "paths": [
+          "outputs/**"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "artifact-body",
+        "priority": 10,
+        "includeBodiesByDefault": false
+      },
+      {
+        "id": "active-plan",
+        "label": "Active Plans",
+        "paths": [
+          "docs/plan/**"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "fresh",
+        "role": "active-task-intent",
+        "priority": 95,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-map",
+        "label": "Archive Map",
+        "paths": [
+          "docs/archive/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-map",
+        "priority": 65,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-body",
+        "label": "Archive Body",
+        "paths": [
+          "docs/archive/**"
+        ],
+        "excludePaths": [
+          "docs/archive/README.md"
+        ],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-body",
+        "priority": 20,
+        "includeBodiesByDefault": false
+      },
+      {
+        "id": "docs",
+        "label": "Project Documentation",
+        "paths": [
+          "docs/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-documentation",
+        "priority": 60,
+        "includeBodiesByDefault": true
+      }
+    ]
+  },
+  "traceability": {
+    "required": [
+      "docs/spec/**",
+      "docs/report/**"
+    ],
+    "exclude": [
+      "**/README.md"
+    ],
+    "keys": [
+      {
+        "key": "informedBy",
+        "label": "Informed by",
+        "description": "Research sources or prior findings that justify the direction.",
+        "target": "path",
+        "relation": "informed_by",
+        "weight": 4
+      },
+      {
+        "key": "assumptionsDefinedIn",
+        "label": "Assumptions defined in",
+        "description": "Documents defining assumptions that bound the claim.",
+        "target": "path",
+        "relation": "assumptions_defined_in",
+        "weight": 4
+      },
+      {
+        "key": "evaluatedBy",
+        "label": "Evaluated by",
+        "description": "Evaluation protocols or measurement methods.",
+        "target": "path",
+        "relation": "evaluated_by",
+        "weight": 4
+      },
+      {
+        "key": "evidenceRecordedIn",
+        "label": "Evidence recorded in",
+        "description": "Dated experiment, dataset, or validation records.",
+        "target": "path",
+        "relation": "evidence_recorded_in",
+        "weight": 4
+      }
+    ]
+  },
+  "validation": {
+    "markdown": {
+      "maxLines": 200,
+      "maxChars": 10000,
+      "exclude": [],
+      "filename": {
+        "warnNumberedSeries": true,
+        "allow": []
+      }
+    }
+  },
+  "impactRanking": {
+    "semantic": {
+      "enabled": true,
+      "threshold": 0.5,
+      "topKPerFile": 5
+    }
+  },
+  "referenceExpansion": {
+    "fuzzy": {
+      "lowSignal": {
+        "add": [],
+        "remove": []
+      }
+    }
+  },
+  "load": {
+    "pinnedPaths": [],
+    "pinnedBodies": [],
+    "documentationSummary": {
+      "exclude": [
+        "docs/plan",
+        "docs/archive"
+      ]
+    }
+  },
+  "planMode": {
+    "writablePaths": [
+      "docs/plan/**",
+      "docs/archive/**"
+    ]
+  }
+}

package/skills/project-initializer/templates/software.json

@@ -0,0 +1,239 @@
+{
+  "documentation": {
+    "root": "docs"
+  },
+  "memory": {
+    "areas": [
+      {
+        "id": "rules",
+        "label": "Agent Rules",
+        "paths": [
+          "AGENTS.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-working-rules",
+        "priority": 100,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "agent-entrypoint",
+        "label": "Agent Entrypoints",
+        "paths": [
+          "CLAUDE.md",
+          "CODEX.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-specific-entrypoint",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "project-overview",
+        "label": "Project Overview",
+        "paths": [
+          "README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-map",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "docs-index",
+        "label": "Docs Index",
+        "paths": [
+          "docs/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "documentation-routing-map",
+        "priority": 90,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "spec",
+        "label": "Product Specs",
+        "paths": [
+          "docs/spec/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "behavior-truth",
+        "priority": 80,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "architecture",
+        "label": "Architecture",
+        "paths": [
+          "docs/arch/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "architecture-rationale",
+        "priority": 75,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "test",
+        "label": "Tests",
+        "paths": [
+          "docs/test/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "verification-knowledge",
+        "priority": 70,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "active-plan",
+        "label": "Active Plans",
+        "paths": [
+          "docs/plan/**"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "fresh",
+        "role": "active-task-intent",
+        "priority": 95,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-map",
+        "label": "Archive Map",
+        "paths": [
+          "docs/archive/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-map",
+        "priority": 65,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-body",
+        "label": "Archive Body",
+        "paths": [
+          "docs/archive/**"
+        ],
+        "excludePaths": [
+          "docs/archive/README.md"
+        ],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-body",
+        "priority": 20,
+        "includeBodiesByDefault": false
+      },
+      {
+        "id": "docs",
+        "label": "Project Documentation",
+        "paths": [
+          "docs/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-documentation",
+        "priority": 60,
+        "includeBodiesByDefault": true
+      }
+    ]
+  },
+  "traceability": {
+    "required": [
+      "docs/spec/**"
+    ],
+    "exclude": [
+      "**/README.md"
+    ],
+    "keys": [
+      {
+        "key": "implementedBy",
+        "label": "Implemented by",
+        "description": "Files that implement the behavior.",
+        "target": "path",
+        "relation": "implemented_by",
+        "weight": 4
+      },
+      {
+        "key": "verifiedBy",
+        "label": "Verified by",
+        "description": "Tests or maintained verification documents.",
+        "target": "path",
+        "relation": "verified_by",
+        "weight": 4
+      },
+      {
+        "key": "relatedDocs",
+        "label": "Related docs",
+        "description": "Documents needed to interpret the behavior.",
+        "target": "path",
+        "relation": "related_doc",
+        "weight": 3
+      },
+      {
+        "key": "designDecisions",
+        "label": "Design decisions",
+        "description": "Maintained architecture or design decision documents that constrain the behavior.",
+        "target": "path",
+        "relation": "design_decision",
+        "weight": 3
+      }
+    ]
+  },
+  "validation": {
+    "markdown": {
+      "maxLines": 200,
+      "maxChars": 10000,
+      "exclude": [],
+      "filename": {
+        "warnNumberedSeries": true,
+        "allow": []
+      }
+    }
+  },
+  "impactRanking": {
+    "semantic": {
+      "enabled": true,
+      "threshold": 0.5,
+      "topKPerFile": 5
+    }
+  },
+  "referenceExpansion": {
+    "fuzzy": {
+      "lowSignal": {
+        "add": [],
+        "remove": []
+      }
+    }
+  },
+  "load": {
+    "pinnedPaths": [],
+    "pinnedBodies": [],
+    "documentationSummary": {
+      "exclude": [
+        "docs/plan",
+        "docs/archive"
+      ]
+    }
+  },
+  "planMode": {
+    "writablePaths": [
+      "docs/plan/**",
+      "docs/archive/**"
+    ]
+  }
+}

package/skills/project-load/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: project-load
+description: Project Load for dotdotgod project memory in Hermes CLI and messaging gateway.
+---
+
+<!-- Generated from packages/shared resources by scripts/generate-adapters.mjs. Do not edit this file directly; edit the shared source and run `pnpm run generate`. -->
+
+# Project Load
+
+Use the operator-authorized selected repository. Prefer the native dotdotgod_project_initialize, dotdotgod_project_load and dotdotgod_project_impact tools for their respective workflows. Context tools use dotdotgod_ names; results contain content and structuredContent, not Pi codemode objects. Do not bypass host permissions or pending impact gates. Hermes native delegate_task handles delegation; this adapter has no Plan Mode.
+
+## CLI Context
+
+Run `dotdotgod map <root> --depth 5 --json` for a broad documentation map. With focus text, run `dotdotgod query <root> "<focus>" --limit 30 --json` and `dotdotgod map <root> --depth 3 --json`. The map command resolves the configured documentation root and exclusions. If the CLI is unavailable, continue from the documentation tree and README indexes.
+
+## Goal
+
+Load the repository's dotdotgod project memory without modifying maintained files. Treat free-form arguments as query text, not mode switches.
+
+## Workflow
+
+1. Identify the repository root. Expose `Help: dotdotgod --help` as optional CLI discovery guidance without checking or reporting installation status, and do not require Help execution for Load to continue.
+2. When baseline context is missing, read `AGENTS.md`, the adapter entrypoint, `README.md`, and `docs/README.md` when present.
+3. Without arguments, run `dotdotgod map <root> --depth 5 --json` and use its configured prefix-compressed documentation tree. The command owns `documentation.root`, `load.documentationSummary.exclude`, deterministic Markdown discovery, and boundary summaries.
+4. With arguments, run `dotdotgod query <root> "<focus>" --limit 30 --json` for at most 30 distinct Markdown files and `dotdotgod map <root> --depth 3 --json` for the configured navigation tree.
+5. If the CLI or shell execution is unavailable, preserve Load behavior by building the same tree from the configured documentation root when known, excluding local memory, and using README routing. At the depth boundary, list every direct Markdown file and immediate child directory, then summarize hidden descendants separately under each named child with exact recursive directory and Markdown-file counts.
+6. Read bodies selectively from query results, explicit paths, and README indexes. Read relevant active plans only when needed, use `docs/archive/README.md` (or the configured archive `README.md` under an alternate documentation root) as the history map, and avoid broad generated, dependency, cache, or secret reads.
+
+## Output
+
+Report the project purpose, key rules, relevant documentation routes, and only the active-plan or next-read hints needed for the request. Keep compact loads to a brief refresh.