Skip to content

armgit / ECC

Public Imported from GitHub
0

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.example
new file mode 100644
index 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.md
new file mode 100644
index 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.md
index 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/.gitignore
index 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
*.pem
secrets.json
+config/secrets.yml
+.secrets
# OS files
.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
Thumbs.db
+Desktop.ini
# Editor files
.idea/
.vscode/
*.swp
*.swo
+*~
+.project
+.classpath
+.settings/
+*.sublime-project
+*.sublime-workspace
# Node
node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+.yarn/
+lerna-debug.log*
-# Build output
+# Build outputs
dist/
+build/
+*.tsbuildinfo
+.cache/
+
+# Test coverage
coverage/
+.nyc_output/
+
+# Logs
+logs/
+*.log
# Python
__pycache__/
@@ -42,3 +75,15 @@ examples/sessions/*.tmp
# Local drafts
marketing/
.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.json
index 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-versions
new file mode 100644
index 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.8
diff --git a/VERSION b/VERSION
new file mode 100644
index 000000000..6e8bf73aa
--- /dev/null
+++ b/VERSION
@@ -0,0 +1 @@
+0.1.0