The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
chore(config): governance and config foundation (#292)
alfraido86-jpg3b2e1745e9cc
diff --git a/.env.example b/.env.examplenew file mode 100644index 000000000..c37740c38--- /dev/null+++ b/.env.example@@ -0,0 +1,38 @@+# .env.example — Canonical list of required environment variables+# Copy this file to .env and fill in real values.+# NEVER commit .env to version control.+#+# Usage:+# cp .env.example .env+# # Then edit .env with your actual values++# ─── Anthropic ────────────────────────────────────────────────────────────────+# Your Anthropic API key (https://console.anthropic.com)+ANTHROPIC_API_KEY=++# ─── GitHub ───────────────────────────────────────────────────────────────────+# GitHub personal access token (for MCP GitHub server)+GITHUB_TOKEN=++# ─── Optional: Docker platform override ──────────────────────────────────────+# DOCKER_PLATFORM=linux/arm64 # or linux/amd64 for Intel Macs / CI++# ─── Optional: Package manager override ──────────────────────────────────────+# CLAUDE_CODE_PACKAGE_MANAGER=npm # npm | pnpm | yarn | bun++# ─── Session & Security ─────────────────────────────────────────────────────+# GitHub username (used by CI scripts for credential context)+GITHUB_USER="your-github-username"++# Primary development branch for CI diff-based checks+DEFAULT_BASE_BRANCH="main"++# Path to session-start.sh (used by test/test_session_start.sh)+SESSION_SCRIPT="./session-start.sh"++# Path to generated MCP configuration file+CONFIG_FILE="./mcp-config.json"++# ─── Optional: Verbose Logging ──────────────────────────────────────────────+# Enable verbose logging for session and CI scripts+ENABLE_VERBOSE_LOGGING="false"diff --git a/.github/ISSUE_TEMPLATE/copilot-task.md b/.github/ISSUE_TEMPLATE/copilot-task.mdnew file mode 100644index 000000000..a545c9b87--- /dev/null+++ b/.github/ISSUE_TEMPLATE/copilot-task.md@@ -0,0 +1,17 @@+---+name: Copilot Task+about: Assign a coding task to GitHub Copilot agent+title: "[Copilot] "+labels: copilot+assignees: copilot+---++## Task Description+<!-- What should Copilot do? Be specific. -->++## Acceptance Criteria+- [ ] ...+- [ ] ...++## Context+<!-- Any relevant files, APIs, or constraints Copilot should know about -->diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.mdindex 7dc306032..fdade2cda 100644--- a/.github/PULL_REQUEST_TEMPLATE.md+++ b/.github/PULL_REQUEST_TEMPLATE.md@@ -1,5 +1,14 @@-## Description-<!-- Brief description of changes -->+## What Changed+<!-- Describe the specific changes made in this PR -->++## Why This Change+<!-- Explain the motivation and context for this change -->++## Testing Done+<!-- Describe the testing you performed to validate your changes -->+- [ ] Manual testing completed+- [ ] Automated tests pass locally (`node tests/run-all.js`)+- [ ] Edge cases considered and tested## Type of Change- [ ] `fix:` Bug fix@@ -10,8 +19,15 @@- [ ] `chore:` Maintenance/tooling- [ ] `ci:` CI/CD changes-## Checklist-- [ ] Tests pass locally (`node tests/run-all.js`)-- [ ] Validation scripts pass+## Security & Quality Checklist+- [ ] No secrets or API keys committed (ghp_, sk-, AKIA, xoxb, xoxp patterns checked)+- [ ] JSON files validate cleanly+- [ ] Shell scripts pass shellcheck (if applicable)+- [ ] Pre-commit hooks pass locally (if configured)+- [ ] No sensitive data exposed in logs or output- [ ] Follows conventional commits format++## Documentation- [ ] Updated relevant documentation+- [ ] Added comments for complex logic+- [ ] README updated (if needed)diff --git a/.gitignore b/.gitignoreindex c7aaa2cfd..049ef53b2 100644--- a/.gitignore+++ b/.gitignore@@ -2,28 +2,61 @@.env.env.local.env.*.local+.env.development+.env.test+.env.production-# API keys+# API keys and secrets*.key*.pemsecrets.json+config/secrets.yml+.secrets# OS files.DS_Store+.DS_Store?+._*+.Spotlight-V100+.Trashes+ehthumbs.dbThumbs.db+Desktop.ini# Editor files.idea/.vscode/*.swp*.swo+*~+.project+.classpath+.settings/+*.sublime-project+*.sublime-workspace# Nodenode_modules/+npm-debug.log*+yarn-debug.log*+yarn-error.log*+.pnpm-debug.log*+.yarn/+lerna-debug.log*-# Build output+# Build outputsdist/+build/+*.tsbuildinfo+.cache/++# Test coveragecoverage/+.nyc_output/++# Logs+logs/+*.log# Python__pycache__/@@ -42,3 +75,15 @@ examples/sessions/*.tmp# Local draftsmarketing/.dmux/++# Temporary files+tmp/+temp/+*.tmp+*.bak+*.backup++# Bootstrap pipeline outputs+# Generated lock files in tool subdirectories+.opencode/package-lock.json+.opencode/node_modules/diff --git a/.markdownlint.json b/.markdownlint.jsonindex 39c81fb66..a002aac16 100644--- a/.markdownlint.json+++ b/.markdownlint.json@@ -1,5 +1,7 @@{+ "globs": ["**/*.md", "!**/node_modules/**"],"default": true,+ "MD009": { "br_spaces": 2, "strict": false },"MD013": false,"MD033": false,"MD041": false,@@ -14,4 +16,4 @@"MD024": {"siblings_only": true}-}\ No newline at end of file+}diff --git a/.tool-versions b/.tool-versionsnew file mode 100644index 000000000..d49da16b1--- /dev/null+++ b/.tool-versions@@ -0,0 +1,6 @@+# .tool-versions — Tool version pins for asdf (https://asdf-vm.com)+# Install asdf, then run: asdf install+# These versions are also compatible with mise (https://mise.jdx.dev).++nodejs 20.19.0+python 3.12.8diff --git a/VERSION b/VERSIONnew file mode 100644index 000000000..6e8bf73aa--- /dev/null+++ b/VERSION@@ -0,0 +1 @@+0.1.0