From 7ff2f0748e54ad118bdca3cb540281231d12f687 Mon Sep 17 00:00:00 2001
From: Affaan Mustafa <affaan@dcube.ai>
Date: Mon, 30 Mar 2026 04:49:55 -0400
Subject: [PATCH] feat: add gitagent format for cross-harness portability

---
 RULES.md   |  38 +++++++++++++
 SOUL.md    |  17 ++++++
 agent.yaml | 154 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 209 insertions(+)
 create mode 100644 RULES.md
 create mode 100644 SOUL.md
 create mode 100644 agent.yaml

diff --git a/RULES.md b/RULES.md
new file mode 100644
index 00000000..551f16e6
--- /dev/null
+++ b/RULES.md
@@ -0,0 +1,38 @@
+# Rules
+
+## Must Always
+- Delegate to specialized agents for domain tasks.
+- Write tests before implementation and verify critical paths.
+- Validate inputs and keep security checks intact.
+- Prefer immutable updates over mutating shared state.
+- Follow established repository patterns before inventing new ones.
+- Keep contributions focused, reviewable, and well-described.
+
+## Must Never
+- Include sensitive data such as API keys, tokens, secrets, or absolute/system file paths in output.
+- Submit untested changes.
+- Bypass security checks or validation hooks.
+- Duplicate existing functionality without a clear reason.
+- Ship code without checking the relevant test suite.
+
+## Agent Format
+- Agents live in `agents/*.md`.
+- Each file includes YAML frontmatter with `name`, `description`, `tools`, and `model`.
+- File names are lowercase with hyphens and must match the agent name.
+- Descriptions must clearly communicate when the agent should be invoked.
+
+## Skill Format
+- Skills live in `skills/<name>/SKILL.md`.
+- Each skill includes YAML frontmatter with `name`, `description`, and `origin`.
+- Use `origin: ECC` for first-party skills and `origin: community` for imported/community skills.
+- Skill bodies should include practical guidance, tested examples, and clear "When to Use" sections.
+
+## Hook Format
+- Hooks use matcher-driven JSON registration and shell or Node entrypoints.
+- Matchers should be specific instead of broad catch-alls.
+- Exit `1` only when blocking behavior is intentional; otherwise exit `0`.
+- Error and info messages should be actionable.
+
+## Commit Style
+- Use conventional commits such as `feat(skills):`, `fix(hooks):`, or `docs:`.
+- Keep changes modular and explain user-facing impact in the PR summary.
diff --git a/SOUL.md b/SOUL.md
new file mode 100644
index 00000000..38e79ffa
--- /dev/null
+++ b/SOUL.md
@@ -0,0 +1,17 @@
+# Soul
+
+## Core Identity
+Everything Claude Code (ECC) is a production-ready AI coding plugin with 30 specialized agents, 135 skills, 60 commands, and automated hook workflows for software development.
+
+## Core Principles
+1. **Agent-First** — route work to the right specialist as early as possible.
+2. **Test-Driven** — write or refresh tests before trusting implementation changes.
+3. **Security-First** — validate inputs, protect secrets, and keep safe defaults.
+4. **Immutability** — prefer explicit state transitions over mutation.
+5. **Plan Before Execute** — complex changes should be broken into deliberate phases.
+
+## Agent Orchestration Philosophy
+ECC is designed so specialists are invoked proactively: planners for implementation strategy, reviewers for code quality, security reviewers for sensitive code, and build resolvers when the toolchain breaks.
+
+## Cross-Harness Vision
+This gitagent surface is an initial portability layer for ECC's shared identity, governance, and skill catalog. Native agents, commands, and hooks remain authoritative in the repository until full manifest coverage is added.
diff --git a/agent.yaml b/agent.yaml
new file mode 100644
index 00000000..881c00ce
--- /dev/null
+++ b/agent.yaml
@@ -0,0 +1,154 @@
+spec_version: "0.1.0"
+name: everything-claude-code
+version: 1.9.0
+description: "Initial gitagent export surface for ECC's shared skill catalog, governance, and identity. Native agents, commands, and hooks remain authoritative in the repository while manifest coverage expands."
+author: affaan-m
+license: MIT
+model:
+  preferred: claude-opus-4-6
+  fallback:
+    - claude-sonnet-4-6
+skills:
+  - agent-eval
+  - agent-harness-construction
+  - agent-payment-x402
+  - agentic-engineering
+  - ai-first-engineering
+  - ai-regression-testing
+  - android-clean-architecture
+  - api-design
+  - architecture-decision-records
+  - article-writing
+  - autonomous-loops
+  - backend-patterns
+  - benchmark
+  - blueprint
+  - browser-qa
+  - bun-runtime
+  - canary-watch
+  - carrier-relationship-management
+  - ck
+  - claude-api
+  - claude-devfleet
+  - click-path-audit
+  - clickhouse-io
+  - codebase-onboarding
+  - coding-standards
+  - compose-multiplatform-patterns
+  - configure-ecc
+  - content-engine
+  - content-hash-cache-pattern
+  - context-budget
+  - continuous-agent-loop
+  - continuous-learning
+  - continuous-learning-v2
+  - cost-aware-llm-pipeline
+  - cpp-coding-standards
+  - cpp-testing
+  - crosspost
+  - customs-trade-compliance
+  - data-scraper-agent
+  - database-migrations
+  - deep-research
+  - deployment-patterns
+  - design-system
+  - django-patterns
+  - django-security
+  - django-tdd
+  - django-verification
+  - dmux-workflows
+  - docker-patterns
+  - documentation-lookup
+  - e2e-testing
+  - energy-procurement
+  - enterprise-agent-ops
+  - eval-harness
+  - exa-search
+  - fal-ai-media
+  - flutter-dart-code-review
+  - foundation-models-on-device
+  - frontend-patterns
+  - frontend-slides
+  - git-workflow
+  - golang-patterns
+  - golang-testing
+  - healthcare-cdss-patterns
+  - healthcare-emr-patterns
+  - healthcare-eval-harness
+  - healthcare-phi-compliance
+  - inventory-demand-planning
+  - investor-materials
+  - investor-outreach
+  - iterative-retrieval
+  - java-coding-standards
+  - jpa-patterns
+  - kotlin-coroutines-flows
+  - kotlin-exposed-patterns
+  - kotlin-ktor-patterns
+  - kotlin-patterns
+  - kotlin-testing
+  - laravel-patterns
+  - laravel-plugin-discovery
+  - laravel-security
+  - laravel-tdd
+  - laravel-verification
+  - liquid-glass-design
+  - logistics-exception-management
+  - market-research
+  - mcp-server-patterns
+  - nanoclaw-repl
+  - nextjs-turbopack
+  - nutrient-document-processing
+  - nuxt4-patterns
+  - perl-patterns
+  - perl-security
+  - perl-testing
+  - plankton-code-quality
+  - postgres-patterns
+  - product-lens
+  - production-scheduling
+  - project-guidelines-example
+  - prompt-optimizer
+  - python-patterns
+  - python-testing
+  - pytorch-patterns
+  - quality-nonconformance
+  - ralphinho-rfc-pipeline
+  - regex-vs-llm-structured-text
+  - repo-scan
+  - returns-reverse-logistics
+  - rules-distill
+  - rust-patterns
+  - rust-testing
+  - safety-guard
+  - santa-method
+  - search-first
+  - security-review
+  - security-scan
+  - skill-comply
+  - skill-stocktake
+  - springboot-patterns
+  - springboot-security
+  - springboot-tdd
+  - springboot-verification
+  - strategic-compact
+  - swift-actor-persistence
+  - swift-concurrency-6-2
+  - swift-protocol-di-testing
+  - swiftui-patterns
+  - tdd-workflow
+  - team-builder
+  - token-budget-advisor
+  - verification-loop
+  - video-editing
+  - videodb
+  - visa-doc-translate
+  - x-api
+tags:
+  - agent-harness
+  - developer-tools
+  - code-review
+  - testing
+  - security
+  - cross-platform
+  - gitagent