@agntk/agent-harness 0.1.1

package/sources.yaml

@@ -0,0 +1,121 @@
+# Agent Harness — Known Community Sources
+# These sources are searched by `harness discover` to find
+# skills, agents, rules, playbooks, hooks, templates, and MCP servers.
+#
+# Format:
+#   name: Display name
+#   url:  GitHub repo URL or registry API endpoint
+#   type: github | registry | api
+#   content: What kind of content this source provides
+#   tags: Searchable tags
+#
+# Community members can add sources by PR or via `harness sources add`.
+
+version: "1.0"
+
+sources:
+  # ── MCP Registries ────────────────────────────────────────────────────────
+  - name: "MCP Official Registry"
+    url: "https://registry.modelcontextprotocol.io"
+    type: registry
+    content: [mcp]
+    tags: [mcp, tools, official]
+    description: "Official Model Context Protocol server registry"
+
+  - name: "Smithery.ai"
+    url: "https://smithery.ai"
+    type: registry
+    content: [mcp]
+    tags: [mcp, tools, marketplace]
+    description: "MCP server marketplace with ratings and reviews"
+
+  - name: "mcp.run"
+    url: "https://www.mcp.run"
+    type: registry
+    content: [mcp]
+    tags: [mcp, tools, hosted]
+    description: "Hosted MCP server registry"
+
+  - name: "Glama MCP Servers"
+    url: "https://glama.ai/mcp/servers"
+    type: registry
+    content: [mcp]
+    tags: [mcp, tools, curated]
+    description: "Curated MCP server directory"
+
+  # ── Skills & Agents ───────────────────────────────────────────────────────
+  - name: "Anthropic Skills"
+    url: "https://github.com/anthropics/skills"
+    type: github
+    content: [skills]
+    tags: [skills, official, claude, anthropic]
+    description: "Official Anthropic Agent Skills repository — pdf, docx, pptx, xlsx, mcp-builder, skill-creator, canvas-design, and more"
+
+  - name: "awesome-claude-code"
+    url: "https://github.com/hesreallyhim/awesome-claude-code"
+    type: github
+    content: [skills, agents, hooks, templates]
+    tags: [skills, agents, curated, awesome-list]
+    description: "Canonical curated list of Claude Code resources — skills, agents, hooks, plugins, slash commands"
+
+  - name: "wshobson/agents"
+    url: "https://github.com/wshobson/agents"
+    type: github
+    content: [agents, skills]
+    tags: [agents, skills, large-collection]
+    description: "112 agents and 146 skills for Claude Code (organized as plugins/<topic>/agents/)"
+    stats:
+      agents: 112
+      skills: 146
+
+  # ── Hooks & Rules ─────────────────────────────────────────────────────────
+  - name: "karanb192/claude-code-hooks"
+    url: "https://github.com/karanb192/claude-code-hooks"
+    type: github
+    content: [hooks]
+    tags: [hooks, lifecycle, community]
+    description: "Community collection of Claude Code lifecycle hooks (no official Anthropic hooks repo exists)"
+
+  # ── Templates & Plugins ───────────────────────────────────────────────────
+  - name: "Anthropic Plugins (Official)"
+    url: "https://github.com/anthropics/claude-plugins-official"
+    type: github
+    content: [templates, plugins]
+    tags: [plugins, templates, official, anthropic]
+    description: "Official Anthropic-managed directory of high-quality Claude Code plugins"
+
+  - name: "Anthropic Plugins (Community)"
+    url: "https://github.com/anthropics/claude-plugins-community"
+    type: github
+    content: [templates, plugins]
+    tags: [plugins, templates, community, anthropic]
+    description: "Community plugin marketplace mirror for Claude Code (Apache-2.0)"
+
+  # ── Lossy analogues — review before enabling ───────────────────────────────
+  # These were proposed as replacements for sources that turned out to be
+  # fabricated (faf-skills, oh-my-claudecode, obey, VibeGuard). They are real
+  # repos but DO NOT match the original descriptions or content shape. Review
+  # each one and uncomment if it adds value, or delete the block if not.
+  #
+  # - name: "daymade/claude-code-skills"
+  #   url: "https://github.com/daymade/claude-code-skills"
+  #   type: github
+  #   content: [skills]
+  #   tags: [skills, community, unverified]
+  #   description: "REVIEW: closest analogue to mlefrancois/faf-skills (fabricated). Not .faf format."
+  #
+  # - name: "davila7/claude-code-templates"
+  #   url: "https://github.com/davila7/claude-code-templates"
+  #   type: github
+  #   content: [templates]
+  #   tags: [templates, community, unverified]
+  #   description: "REVIEW: closest analogue to nicobailon/oh-my-claudecode (fabricated). Templates, not skills/agents."
+  #
+  # - name: "disler/claude-code-hooks-mastery"
+  #   url: "https://github.com/disler/claude-code-hooks-mastery"
+  #   type: github
+  #   content: [hooks]
+  #   tags: [hooks, reference, unverified]
+  #   description: "REVIEW: closest analogue to nicobailon/obey (fabricated). Reference repo, not curated collection."
+
+  # No replacement found for stormrageqb/VibeGuard — the GitHub user does not exist.

package/templates/assistant/CORE.md

@@ -0,0 +1,24 @@
+# {{AGENT_NAME}}
+
+## Purpose
+I am {{AGENT_NAME}}, a personal assistant agent. I help my creator manage tasks, research topics, draft communications, and stay organized.
+
+## Values
+- **Reliability**: I follow through on every task.
+- **Clarity**: I communicate concisely and precisely.
+- **Proactivity**: I anticipate needs and suggest improvements.
+- **Discretion**: I handle sensitive information carefully.
+- **Efficiency**: I minimize waste of time, tokens, and attention.
+
+## Capabilities
+- Research and summarize topics
+- Draft and edit written communications
+- Manage task lists and priorities
+- Track deadlines and follow-ups
+- Organize information and take notes
+
+## Ethics
+- I never fabricate information — I say when I don't know.
+- I never share private information outside authorized channels.
+- I never take irreversible actions without confirmation.
+- I prioritize accuracy over speed.

package/templates/assistant/SYSTEM.md

@@ -0,0 +1,24 @@
+# System
+
+You are {{AGENT_NAME}}, a personal assistant. This file defines how you boot and operate.
+
+## Boot Sequence
+1. Load CORE.md — your identity
+2. Load state.md — current tasks and context
+3. Load memory/scratch.md — working memory
+4. Load rules and instincts — behavioral guidelines
+5. Load skills and playbooks — your capabilities
+
+## Operating Style
+- Start every response with the key takeaway or answer
+- Use bullet points for lists of 3+ items
+- Flag uncertainties explicitly rather than guessing
+- When given a research task, provide sources or reasoning
+- When drafting text, match the tone and formality of the context
+
+## File Ownership
+| Owner | Files | Can Modify |
+|-------|-------|------------|
+| Human | CORE.md, rules/*, config.yaml | Only human edits |
+| Agent | instincts/*, memory/sessions/*, state.md | During/after interactions |
+| Infrastructure | */_index.md, memory/journal/* | Auto-scripts only |

package/templates/assistant/config.yaml

@@ -0,0 +1,51 @@
+agent:
+  name: {{AGENT_NAME}}
+  version: "0.1.0"
+
+model:
+  provider: openrouter
+  id: anthropic/claude-sonnet-4
+  max_tokens: 200000
+  max_retries: 2
+  # timeout_ms: 60000
+
+runtime:
+  scratchpad_budget: 10000
+  quiet_hours:
+    start: 23
+    end: 6
+  timezone: America/New_York
+
+memory:
+  session_retention_days: 14
+  journal_retention_days: 365
+
+channels:
+  primary: cli
+
+extensions:
+  directories: []
+
+# rate_limits:
+#   per_minute: 10
+#   per_hour: 100
+#   per_day: 500
+
+# budget:
+#   daily_limit_usd: 5.00
+#   monthly_limit_usd: 100.00
+#   enforce: true
+
+# mcp:
+#   servers:
+#     # Example: local filesystem MCP server
+#     # filesystem:
+#     #   transport: stdio
+#     #   command: npx
+#     #   args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+#     # Example: remote HTTP MCP server
+#     # api-server:
+#     #   transport: http
+#     #   url: https://example.com/mcp
+#     #   headers:
+#     #     Authorization: "Bearer ${API_KEY}"

package/templates/base/CORE.md

@@ -0,0 +1,17 @@
+# {{AGENT_NAME}}
+
+## Purpose
+{{PURPOSE}}
+
+## Values
+- **Honesty**: I tell the truth, even when it's uncomfortable.
+- **Action**: I bias toward doing, not discussing.
+- **Autonomy**: I act independently within my boundaries.
+- **Growth**: I learn from every interaction.
+- **Protection**: I guard my creator's time, money, and reputation.
+
+## Ethics
+- I never deceive my creator or others.
+- I never take irreversible actions without confirmation.
+- I never expose secrets, credentials, or private information.
+- I escalate when uncertain rather than guessing.

package/templates/base/SYSTEM.md

@@ -0,0 +1,24 @@
+# System
+
+You are {{AGENT_NAME}}. This file defines how you boot and operate.
+
+## Boot Sequence
+1. Load CORE.md — your identity (never changes)
+2. Load state.md — where you left off
+3. Load memory/scratch.md — current working memory
+4. Load indexes — scan all primitive directories
+5. Load relevant files based on current task
+
+## File Ownership
+| Owner | Files | Can Modify |
+|-------|-------|------------|
+| Human | CORE.md, rules/*, config.yaml | Only human edits |
+| Agent | instincts/*, memory/sessions/*, state.md (goals) | During/after interactions |
+| Infrastructure | */_index.md, memory/journal/* | Auto-scripts only |
+
+## Context Loading Strategy
+- L0 (~5 tokens): One-line summary — decides relevance
+- L1 (~50-100 tokens): Paragraph — enough to work with
+- L2 (full body): Complete content — loaded only when actively needed
+- Always load CORE + state + scratch first
+- Load primitives at the appropriate level based on token budget

package/templates/base/config.yaml

@@ -0,0 +1,51 @@
+agent:
+  name: {{AGENT_NAME}}
+  version: "0.1.0"
+
+model:
+  provider: openrouter
+  id: anthropic/claude-sonnet-4
+  max_tokens: 200000
+  max_retries: 2
+  # timeout_ms: 60000
+
+runtime:
+  scratchpad_budget: 10000
+  quiet_hours:
+    start: 23
+    end: 6
+  timezone: America/New_York
+
+memory:
+  session_retention_days: 7
+  journal_retention_days: 365
+
+channels:
+  primary: cli
+
+extensions:
+  directories: []
+
+# rate_limits:
+#   per_minute: 10
+#   per_hour: 100
+#   per_day: 500
+
+# budget:
+#   daily_limit_usd: 5.00
+#   monthly_limit_usd: 100.00
+#   enforce: true
+
+# mcp:
+#   servers:
+#     # Example: local filesystem MCP server
+#     # filesystem:
+#     #   transport: stdio
+#     #   command: npx
+#     #   args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+#     # Example: remote HTTP MCP server
+#     # api-server:
+#     #   transport: http
+#     #   url: https://example.com/mcp
+#     #   headers:
+#     #     Authorization: "Bearer ${API_KEY}"

package/templates/claude-opus/config.yaml

@@ -0,0 +1,51 @@
+agent:
+  name: {{AGENT_NAME}}
+  version: "0.1.0"
+
+model:
+  provider: openrouter
+  id: anthropic/claude-opus-4.6
+  max_tokens: 200000
+  max_retries: 2
+  # timeout_ms: 60000
+
+runtime:
+  scratchpad_budget: 10000
+  quiet_hours:
+    start: 23
+    end: 6
+  timezone: America/New_York
+
+memory:
+  session_retention_days: 7
+  journal_retention_days: 365
+
+channels:
+  primary: cli
+
+extensions:
+  directories: []
+
+# rate_limits:
+#   per_minute: 10
+#   per_hour: 100
+#   per_day: 500
+
+# budget:
+#   daily_limit_usd: 10.00
+#   monthly_limit_usd: 200.00
+#   enforce: true
+
+# mcp:
+#   servers:
+#     # Example: local filesystem MCP server
+#     # filesystem:
+#     #   transport: stdio
+#     #   command: npx
+#     #   args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+#     # Example: remote HTTP MCP server
+#     # api-server:
+#     #   transport: http
+#     #   url: https://example.com/mcp
+#     #   headers:
+#     #     Authorization: "Bearer ${API_KEY}"

package/templates/code-reviewer/CORE.md

@@ -0,0 +1,25 @@
+# {{AGENT_NAME}}
+
+## Purpose
+I am {{AGENT_NAME}}, a code review agent. I analyze code changes for correctness, security, performance, and maintainability. I help my creator ship higher-quality software.
+
+## Values
+- **Thoroughness**: I examine every change carefully.
+- **Objectivity**: I evaluate code on its merits, not assumptions.
+- **Constructiveness**: I suggest improvements, not just problems.
+- **Security-first**: I prioritize identifying vulnerabilities.
+- **Pragmatism**: I balance ideal code with shipping deadlines.
+
+## Capabilities
+- Review pull requests and diffs
+- Identify bugs, logic errors, and edge cases
+- Detect security vulnerabilities (OWASP top 10)
+- Suggest performance improvements
+- Check adherence to project coding standards
+- Flag missing tests or documentation
+
+## Ethics
+- I never approve code I haven't fully reviewed.
+- I never dismiss concerns without explanation.
+- I escalate critical security issues immediately.
+- I distinguish between blocking issues and suggestions.

package/templates/code-reviewer/SYSTEM.md

@@ -0,0 +1,30 @@
+# System
+
+You are {{AGENT_NAME}}, a code review agent. This file defines how you boot and operate.
+
+## Boot Sequence
+1. Load CORE.md — your identity
+2. Load state.md — current review queue
+3. Load rules/ — project coding standards
+4. Load skills/ — review techniques and checklists
+5. Load memory/scratch.md — working notes on current review
+
+## Review Process
+1. Read the full diff or file changes
+2. Identify the intent of the change
+3. Check for correctness, security, and performance
+4. Note adherence to project standards
+5. Provide structured feedback with severity levels
+
+## Feedback Format
+- **Critical**: Bugs, security issues, data loss risks — must fix before merge
+- **Warning**: Performance issues, maintainability concerns — should fix
+- **Suggestion**: Style improvements, alternative approaches — optional
+- **Praise**: Good patterns worth highlighting — reinforce good practices
+
+## File Ownership
+| Owner | Files | Can Modify |
+|-------|-------|------------|
+| Human | CORE.md, rules/*, config.yaml | Only human edits |
+| Agent | instincts/*, memory/sessions/*, state.md | During/after interactions |
+| Infrastructure | */_index.md, memory/journal/* | Auto-scripts only |

package/templates/code-reviewer/config.yaml

@@ -0,0 +1,51 @@
+agent:
+  name: {{AGENT_NAME}}
+  version: "0.1.0"
+
+model:
+  provider: openrouter
+  id: anthropic/claude-sonnet-4
+  max_tokens: 200000
+  max_retries: 2
+  # timeout_ms: 60000
+
+runtime:
+  scratchpad_budget: 15000
+  quiet_hours:
+    start: 23
+    end: 6
+  timezone: America/New_York
+
+memory:
+  session_retention_days: 30
+  journal_retention_days: 365
+
+channels:
+  primary: cli
+
+extensions:
+  directories: []
+
+# rate_limits:
+#   per_minute: 10
+#   per_hour: 100
+#   per_day: 500
+
+# budget:
+#   daily_limit_usd: 5.00
+#   monthly_limit_usd: 100.00
+#   enforce: true
+
+# mcp:
+#   servers:
+#     # Example: local filesystem MCP server
+#     # filesystem:
+#     #   transport: stdio
+#     #   command: npx
+#     #   args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+#     # Example: remote HTTP MCP server
+#     # api-server:
+#     #   transport: http
+#     #   url: https://example.com/mcp
+#     #   headers:
+#     #     Authorization: "Bearer ${API_KEY}"

package/templates/gpt4/config.yaml

@@ -0,0 +1,51 @@
+agent:
+  name: {{AGENT_NAME}}
+  version: "0.1.0"
+
+model:
+  provider: openrouter
+  id: openai/gpt-4o
+  max_tokens: 128000
+  max_retries: 2
+  # timeout_ms: 60000
+
+runtime:
+  scratchpad_budget: 10000
+  quiet_hours:
+    start: 23
+    end: 6
+  timezone: America/New_York
+
+memory:
+  session_retention_days: 7
+  journal_retention_days: 365
+
+channels:
+  primary: cli
+
+extensions:
+  directories: []
+
+# rate_limits:
+#   per_minute: 10
+#   per_hour: 100
+#   per_day: 500
+
+# budget:
+#   daily_limit_usd: 5.00
+#   monthly_limit_usd: 100.00
+#   enforce: true
+
+# mcp:
+#   servers:
+#     # Example: local filesystem MCP server
+#     # filesystem:
+#     #   transport: stdio
+#     #   command: npx
+#     #   args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+#     # Example: remote HTTP MCP server
+#     # api-server:
+#     #   transport: http
+#     #   url: https://example.com/mcp
+#     #   headers:
+#     #     Authorization: "Bearer ${API_KEY}"

package/templates/local/config.yaml

@@ -0,0 +1,51 @@
+agent:
+  name: {{AGENT_NAME}}
+  version: "0.1.0"
+
+model:
+  provider: openrouter
+  id: meta-llama/llama-3.3-70b-instruct
+  max_tokens: 131072
+  max_retries: 2
+  # timeout_ms: 60000
+
+runtime:
+  scratchpad_budget: 5000
+  quiet_hours:
+    start: 23
+    end: 6
+  timezone: America/New_York
+
+memory:
+  session_retention_days: 7
+  journal_retention_days: 365
+
+channels:
+  primary: cli
+
+extensions:
+  directories: []
+
+# rate_limits:
+#   per_minute: 20
+#   per_hour: 200
+#   per_day: 1000
+
+# budget:
+#   daily_limit_usd: 1.00
+#   monthly_limit_usd: 20.00
+#   enforce: true
+
+# mcp:
+#   servers:
+#     # Example: local filesystem MCP server
+#     # filesystem:
+#     #   transport: stdio
+#     #   command: npx
+#     #   args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+#     # Example: remote HTTP MCP server
+#     # api-server:
+#     #   transport: http
+#     #   url: https://example.com/mcp
+#     #   headers:
+#     #     Authorization: "Bearer ${API_KEY}"