{"_id":"@shreyaskapale/gitagent","_rev":"8-62402643cb81dc68bb4dce623f71aa18","name":"@shreyaskapale/gitagent","dist-tags":{"latest":"0.1.7"},"versions":{"0.1.0":{"name":"@shreyaskapale/gitagent","version":"0.1.0","keywords":["ai","agent","git","mcp","a2a","finra","compliance"],"author":{"name":"shreyaskapale"},"license":"MIT","_id":"@shreyaskapale/gitagent@0.1.0","maintainers":[{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"}],"homepage":"https://gitagent.sh","bugs":{"url":"https://github.com/open-gitagent/gitagent/issues"},"bin":{"gitagent":"dist/index.js"},"dist":{"shasum":"7cbb4333394a982fc899d658c0b69c7e0d3c3962","tarball":"https://registry.npmjs.org/@shreyaskapale/gitagent/-/gitagent-0.1.0.tgz","fileCount":190,"integrity":"sha512-v6sbeldEH8S28gU21Bk07lyPKkpaYDSPc2MCAys9N2yoYbnz4J9YP/QJY3su/baMoymvos1gLQKW38dlfk5n3Q==","signatures":[{"sig":"MEYCIQDVi1GxdOwzzfp6LVlTFV+uNkIYv44/tmtiFJjssUtFnQIhAN/kd4a46wDjjGiE2ho9k1yTerNDEXSj6Xm19TeoW178","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":539463},"type":"module","engines":{"node":">=18"},"gitHead":"6d8eaad95a26227d1b2e6388ad89339bb0d85c37","scripts":{"dev":"tsc --watch","test":"node --test dist/**/*.test.js","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"},"repository":{"url":"git+https://github.com/open-gitagent/gitagent.git","type":"git"},"_npmVersion":"10.8.2","description":"A framework-agnostic, git-native standard for defining AI agents","directories":{},"_nodeVersion":"20.18.1","dependencies":{"ajv":"^8.17.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","ajv-formats":"^3.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/gitagent_0.1.0_1771949593352_0.7649025132523488","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@shreyaskapale/gitagent","version":"0.1.1","keywords":["ai","agent","git","mcp","a2a","finra","compliance"],"author":{"name":"shreyaskapale"},"license":"MIT","_id":"@shreyaskapale/gitagent@0.1.1","maintainers":[{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"}],"homepage":"https://gitagent.sh","bugs":{"url":"https://github.com/open-gitagent/gitagent/issues"},"bin":{"gitagent":"dist/index.js"},"dist":{"shasum":"48b5a1466d8aabb3d2486451f89bd93e12cc343d","tarball":"https://registry.npmjs.org/@shreyaskapale/gitagent/-/gitagent-0.1.1.tgz","fileCount":190,"integrity":"sha512-5jE85hrWx9dblxssxx5K39Oki8kile1TvE4F6bBwR47pfc+T2mRMnAly/gqx0VPJra4Uvo9WVar2KxDkof6eVA==","signatures":[{"sig":"MEYCIQC+aSQkPIK3e/wgAX9S94pFvvLv+R0ClmfiZm7SpswAbwIhAOLLvFC5Jj6LaWKtz+N2F7n2uER3Qsnf5Rjp1PgwB+7F","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":540246},"type":"module","engines":{"node":">=18"},"gitHead":"5cd530bf476ae57100d1e9a9abea6c5b9e2c0e98","scripts":{"dev":"tsc --watch","test":"node --test dist/**/*.test.js","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"},"repository":{"url":"git+https://github.com/open-gitagent/gitagent.git","type":"git"},"_npmVersion":"10.8.2","description":"A framework-agnostic, git-native standard for defining AI agents","directories":{},"_nodeVersion":"20.18.1","dependencies":{"ajv":"^8.17.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","ajv-formats":"^3.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/gitagent_0.1.1_1771950202935_0.8105813775767017","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@shreyaskapale/gitagent","version":"0.1.2","keywords":["ai","agent","git","mcp","a2a","finra","compliance"],"author":{"name":"shreyaskapale"},"license":"MIT","_id":"@shreyaskapale/gitagent@0.1.2","maintainers":[{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"}],"homepage":"https://gitagent.sh","bugs":{"url":"https://github.com/open-gitagent/gitagent/issues"},"bin":{"gitagent":"dist/index.js"},"dist":{"shasum":"e07c5301d98902032a88b5e50710d1773e11f3aa","tarball":"https://registry.npmjs.org/@shreyaskapale/gitagent/-/gitagent-0.1.2.tgz","fileCount":190,"integrity":"sha512-UhXTOzes8RWCNzLgXEmqr4aaSAtOV+HR1QLcMzaJMGKFLkcCeLMr+bAqNuJWhRbzzSod5YtBEcjmRsKCD3VIKg==","signatures":[{"sig":"MEQCIFln/VAtjU2n5I4is/d8sbHQZmQJGrpCw8kjPBWjFS/zAiBwCSB+E9n9hDDz1UlZaQ9pBCIM0BgyIyjNU6kXVYyW2A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":540270},"type":"module","engines":{"node":">=18"},"gitHead":"ba875c6484775160b744c9ea92117b600bc2ee1b","scripts":{"dev":"tsc --watch","test":"node --test dist/**/*.test.js","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"},"repository":{"url":"git+https://github.com/open-gitagent/gitagent.git","type":"git"},"_npmVersion":"10.8.2","description":"A framework-agnostic, git-native standard for defining AI agents","directories":{},"_nodeVersion":"20.18.1","dependencies":{"ajv":"^8.17.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","ajv-formats":"^3.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/gitagent_0.1.2_1771952890818_0.792300020330559","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@shreyaskapale/gitagent","version":"0.1.3","keywords":["ai","agent","git","mcp","a2a","finra","compliance"],"author":{"name":"shreyaskapale"},"license":"MIT","_id":"@shreyaskapale/gitagent@0.1.3","maintainers":[{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"}],"homepage":"https://gitagent.sh","bugs":{"url":"https://github.com/open-gitagent/gitagent/issues"},"bin":{"gitagent":"dist/index.js"},"dist":{"shasum":"f81c60bba2c718fe9825c9d87fbe3e44275e0ce8","tarball":"https://registry.npmjs.org/@shreyaskapale/gitagent/-/gitagent-0.1.3.tgz","fileCount":190,"integrity":"sha512-kmmvyhqlw0ZWfzhFBbB2dm0TtBepIM2ML8pKYm+GsSpFLMJdYIGliN/SO6q69AMTpv0TTD6JiW35OGHUmMeeyA==","signatures":[{"sig":"MEYCIQDyq8tEU2YVSJKoOXxVlqN5BmVb6kYpjKp8f1hmfpHZ4QIhAIjSKxp+i17bpAjW7C71TRWCZ74NYlaxqRjtlzJl9ivz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":539715},"type":"module","engines":{"node":">=18"},"gitHead":"a57c4f326a3919bd5bed65ed78c18950bcb7179b","scripts":{"dev":"tsc --watch","test":"node --test dist/**/*.test.js","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"},"repository":{"url":"git+https://github.com/open-gitagent/gitagent.git","type":"git"},"_npmVersion":"10.8.2","description":"A framework-agnostic, git-native standard for defining AI agents","directories":{},"_nodeVersion":"20.18.1","dependencies":{"ajv":"^8.17.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","ajv-formats":"^3.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/gitagent_0.1.3_1771953266862_0.7193789786655189","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@shreyaskapale/gitagent","version":"0.1.4","keywords":["ai","agent","git","mcp","a2a","finra","compliance"],"author":{"name":"shreyaskapale"},"license":"MIT","_id":"@shreyaskapale/gitagent@0.1.4","maintainers":[{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"}],"homepage":"https://gitagent.sh","bugs":{"url":"https://github.com/open-gitagent/gitagent/issues"},"bin":{"gitagent":"dist/index.js"},"dist":{"shasum":"d471b0ac95657fadcd67df306a52243aa8fb12be","tarball":"https://registry.npmjs.org/@shreyaskapale/gitagent/-/gitagent-0.1.4.tgz","fileCount":190,"integrity":"sha512-U5JQifVK+E63GXVj3ew1hM2DfshIcdwTcmxz5o5F0zNdG0JPtD57Wlyub1QjEKUVsTrFoTEUeSrCMbBuw+iFtQ==","signatures":[{"sig":"MEUCIHBmmCIKrJNzz6m48AaCpP5x/tvWj9l556PsyjlLNdYZAiEAtABfyycKoTp+ycgWKqAWcibqgIINNcILDpy7Oz6GC/8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":540270},"type":"module","engines":{"node":">=18"},"gitHead":"6c90b36c8933569059943a1f4021ea3c5c77985b","scripts":{"dev":"tsc --watch","test":"node --test dist/**/*.test.js","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"},"repository":{"url":"git+https://github.com/open-gitagent/gitagent.git","type":"git"},"_npmVersion":"10.8.2","description":"A framework-agnostic, git-native standard for defining AI agents","directories":{},"_nodeVersion":"20.18.1","dependencies":{"ajv":"^8.17.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","ajv-formats":"^3.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/gitagent_0.1.4_1771953709071_0.8928900166305445","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@shreyaskapale/gitagent","version":"0.1.5","keywords":["ai","agent","git","mcp","a2a","finra","compliance"],"author":{"name":"shreyaskapale"},"license":"MIT","_id":"@shreyaskapale/gitagent@0.1.5","maintainers":[{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"}],"homepage":"https://gitagent.sh","bugs":{"url":"https://github.com/open-gitagent/gitagent/issues"},"bin":{"gitagent":"dist/index.js"},"dist":{"shasum":"a752d90713556b7f621b473513d22f795d3c6a5a","tarball":"https://registry.npmjs.org/@shreyaskapale/gitagent/-/gitagent-0.1.5.tgz","fileCount":190,"integrity":"sha512-zQVm5mhdSzzD2mcT9ysJCqV/ZxNK+BU+zgAYKyoA4wU8OI6hRNHrI3Mid3UoU4KiR6q9/8/DiEvKk10DFfjBaw==","signatures":[{"sig":"MEUCIQCxhpBsZnjkMGUoQX4I7lN/FigtC7rumdU+CFkBrwyMqwIgArrlC/hoP5TgvB2IXfmzY68SyXaxZHBJcDTAfLPejmI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":541203},"type":"module","engines":{"node":">=18"},"gitHead":"34b1cf646753e0514377306438c292f9f6ada053","scripts":{"dev":"tsc --watch","test":"node --test dist/**/*.test.js","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"},"repository":{"url":"git+https://github.com/open-gitagent/gitagent.git","type":"git"},"_npmVersion":"10.8.2","description":"A framework-agnostic, git-native standard for defining AI agents","directories":{},"_nodeVersion":"20.18.1","dependencies":{"ajv":"^8.17.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","ajv-formats":"^3.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/gitagent_0.1.5_1771954190032_0.04147494666290852","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@shreyaskapale/gitagent","version":"0.1.6","keywords":["ai","agent","git","mcp","a2a","finra","compliance"],"author":{"name":"shreyaskapale"},"license":"MIT","_id":"@shreyaskapale/gitagent@0.1.6","maintainers":[{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"}],"homepage":"https://gitagent.sh","bugs":{"url":"https://github.com/open-gitagent/gitagent/issues"},"bin":{"gitagent":"dist/index.js"},"dist":{"shasum":"3a52cf19ba48611d85007d910b8bac67738805bb","tarball":"https://registry.npmjs.org/@shreyaskapale/gitagent/-/gitagent-0.1.6.tgz","fileCount":190,"integrity":"sha512-p5T2Ww8vCH7FAl61gA2sfQL/Sw9tDjW8peBy/uOCN/wQceKxSFoPxpbqWUgw5R6ddEefr3FfgHkdTrxyE/guIw==","signatures":[{"sig":"MEUCIQDPo6PI17eD339BY1stH8VxhaJEXYFQVQU9QpF7wQishAIgHFXRH29BaBJUB0qRbCJsGMDIK1Sac1oVrDRsgoGDKO0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":541895},"type":"module","engines":{"node":">=18"},"gitHead":"13e21178383cc8f94a9799e87fd7b9f04047f513","scripts":{"dev":"tsc --watch","test":"node --test dist/**/*.test.js","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"},"repository":{"url":"git+https://github.com/open-gitagent/gitagent.git","type":"git"},"_npmVersion":"10.8.2","description":"A framework-agnostic, git-native standard for defining AI agents","directories":{},"_nodeVersion":"20.18.1","dependencies":{"ajv":"^8.17.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","ajv-formats":"^3.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/gitagent_0.1.6_1771954323082_0.6919979763136983","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@shreyaskapale/gitagent","version":"0.1.7","description":"A framework-agnostic, git-native standard for defining AI agents","type":"module","bin":{"gitagent":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","dev":"tsc --watch","start":"node dist/index.js","test":"node --test dist/**/*.test.js","prepublishOnly":"npm run build"},"keywords":["ai","agent","git","mcp","a2a","finra","compliance"],"author":{"name":"shreyaskapale"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/open-gitagent/gitagent.git"},"homepage":"https://gitagent.sh","bugs":{"url":"https://github.com/open-gitagent/gitagent/issues"},"engines":{"node":">=18"},"dependencies":{"ajv":"^8.17.1","ajv-formats":"^3.0.1","chalk":"^5.3.0","commander":"^12.1.0","inquirer":"^9.3.7","js-yaml":"^4.1.0"},"devDependencies":{"@types/inquirer":"^9.0.7","@types/js-yaml":"^4.0.9","@types/node":"^22.10.0","typescript":"^5.7.0"},"_id":"@shreyaskapale/gitagent@0.1.7","gitHead":"06626dfa10739018b5db5c5db7285c67efc1bc34","_nodeVersion":"20.18.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-zZIrEmLGnoebor/u3H65MvJTp6JJWlRLZgvEIJnCmh3ZOnBUvpVAwiE8DHI+RWZb5S2gq+N0BBo4v0iGqijjBg==","shasum":"dcc47237becba0f994afbca8b1f3a662e0ae8e71","tarball":"https://registry.npmjs.org/@shreyaskapale/gitagent/-/gitagent-0.1.7.tgz","fileCount":190,"unpackedSize":542061,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFIL+vkXvSxBOswrLv/jtwrBvAE+vP10oKVdaA850QcyAiBAUC5vLCR07OEGKKaEuMQ7AySMuQoiifNdnM7XNsqW4g=="}]},"_npmUser":{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"},"directories":{},"maintainers":[{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gitagent_0.1.7_1771956868316_0.4878088678460555"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-24T16:13:13.276Z","modified":"2026-02-24T18:14:28.608Z","0.1.0":"2026-02-24T16:13:13.527Z","0.1.1":"2026-02-24T16:23:23.098Z","0.1.2":"2026-02-24T17:08:10.973Z","0.1.3":"2026-02-24T17:14:27.007Z","0.1.4":"2026-02-24T17:21:49.234Z","0.1.5":"2026-02-24T17:29:50.180Z","0.1.6":"2026-02-24T17:32:03.248Z","0.1.7":"2026-02-24T18:14:28.482Z"},"bugs":{"url":"https://github.com/open-gitagent/gitagent/issues"},"author":{"name":"shreyaskapale"},"license":"MIT","homepage":"https://gitagent.sh","keywords":["ai","agent","git","mcp","a2a","finra","compliance"],"repository":{"type":"git","url":"git+https://github.com/open-gitagent/gitagent.git"},"description":"A framework-agnostic, git-native standard for defining AI agents","maintainers":[{"name":"shreyaskapale","email":"kapale.shreyas@gmail.com"}],"readme":"# gitagent\n\nA framework-agnostic, git-native standard for defining AI agents. Clone a repo, get an agent.\n\n## Why\n\nEvery AI framework has its own structure. There's no universal, portable way to define an agent that works across Claude Code, OpenAI, LangChain, CrewAI, and AutoGen. **gitagent** fixes that.\n\n- **Git-native** — Version control, branching, diffing, and collaboration built in\n- **Framework-agnostic** — Export to any framework with adapters\n- **Compliance-ready** — First-class support for FINRA, Federal Reserve, and SEC regulatory requirements\n- **Composable** — Agents can extend, depend on, and delegate to other agents\n\n## Patterns\n\nFour architectural patterns emerge when you treat agents as git repos:\n\n### Human-in-the-Loop for RL Agents\nWhen an agent updates memory or learns a new skill, it creates a branch + PR for human review before merging to main. Git's review workflow becomes your supervision layer.\n\n### Shared Context\nRoot-level `context.md`, `skills/`, `tools/`, and `knowledge/` are automatically inherited by all sub-agents. One source of truth, no duplication.\n\n### Branch-based Deployment\nUse git branches (`dev` → `staging` → `main`) to promote agent changes through environments, just like shipping software.\n\n### Knowledge Tree\nThe `knowledge/` folder stores entity relationships as a hierarchical tree with embeddings, letting agents reason over structured data at runtime.\n\n## Quick Start\n\n```bash\n# Install\nnpm install -g gitagent\n\n# Create a new agent\ngitagent init --template standard\n\n# Validate\ngitagent validate\n\n# View agent info\ngitagent info\n\n# Export to system prompt\ngitagent export --format system-prompt\n```\n\n## Directory Structure\n\n```\nmy-agent/\n├── agent.yaml          # [REQUIRED] Manifest — name, version, model, skills, tools, compliance\n├── SOUL.md             # [REQUIRED] Identity, personality, communication style, values\n├── RULES.md            # Hard constraints, must-always/must-never, safety boundaries\n├── AGENTS.md           # Framework-agnostic fallback instructions\n├── skills/             # Reusable capability modules (SKILL.md + scripts)\n├── tools/              # MCP-compatible tool definitions (YAML schemas)\n├── knowledge/          # Reference documents the agent can consult\n├── memory/             # Persistent cross-session memory\n├── workflows/          # Multi-step procedures/playbooks\n├── hooks/              # Lifecycle event handlers (audit logging, compliance checks)\n├── examples/           # Calibration interactions (few-shot)\n├── agents/             # Sub-agent definitions (recursive structure)\n├── compliance/         # Regulatory compliance artifacts\n├── config/             # Environment-specific overrides\n└── .gitagent/          # Runtime state (gitignored)\n```\n\n## agent.yaml\n\nThe only file with a strict schema. Minimal example:\n\n```yaml\nspec_version: \"0.1.0\"\nname: my-agent\nversion: 0.1.0\ndescription: A helpful assistant agent\n```\n\nFull example with compliance:\n\n```yaml\nspec_version: \"0.1.0\"\nname: compliance-analyst\nversion: 1.0.0\ndescription: Financial compliance analysis agent\nmodel:\n  preferred: claude-opus-4-6\ncompliance:\n  risk_tier: high\n  frameworks: [finra, federal_reserve, sec]\n  supervision:\n    human_in_the_loop: always\n    kill_switch: true\n  recordkeeping:\n    audit_logging: true\n    retention_period: 7y\n    immutable: true\n  model_risk:\n    validation_cadence: quarterly\n    ongoing_monitoring: true\n```\n\n## CLI Commands\n\n| Command | Description |\n|---------|-------------|\n| `gitagent init [--template]` | Scaffold new agent (`minimal`, `standard`, `full`) |\n| `gitagent validate [--compliance]` | Validate against spec and regulatory requirements |\n| `gitagent info` | Display agent summary |\n| `gitagent export --format <fmt>` | Export to other formats (see adapters below) |\n| `gitagent import --from <fmt> <path>` | Import (`claude`, `cursor`, `crewai`) |\n| `gitagent run <source> --adapter <a>` | Run an agent from a git repo or local directory |\n| `gitagent install` | Resolve and install git-based dependencies |\n| `gitagent audit` | Generate compliance audit report |\n| `gitagent skills <cmd>` | Manage skills (`search`, `install`, `list`, `info`) |\n| `gitagent lyzr <cmd>` | Manage Lyzr agents (`create`, `update`, `info`, `run`) |\n\n## Compliance\n\ngitagent has first-class support for financial regulatory compliance:\n\n### FINRA\n- **Rule 3110** — Supervision: human-in-the-loop, escalation triggers, kill switch\n- **Rule 4511** — Recordkeeping: immutable audit logs, retention periods, SEC 17a-4 compliance\n- **Rule 2210** — Communications: fair/balanced enforcement, no misleading statements\n- **Reg Notice 24-09** — Existing rules apply to GenAI/LLMs\n\n### Federal Reserve\n- **SR 11-7** — Model Risk Management: validation cadence, ongoing monitoring, outcomes analysis\n- **SR 23-4** — Third-Party Risk: vendor due diligence, SOC reports, subcontractor assessment\n\n### SEC / CFPB\n- **Reg S-P** — Customer privacy, PII handling\n- **CFPB Circular 2022-03** — Explainable adverse action, Less Discriminatory Alternative search\n\nRun `gitagent audit` for a full compliance checklist against your agent configuration.\n\n## Adapters\n\nAdapters are used by both `export` and `run`. Available adapters:\n\n| Adapter | Description |\n|---------|-------------|\n| `system-prompt` | Concatenated system prompt (works with any LLM) |\n| `claude-code` | Claude Code compatible CLAUDE.md |\n| `openai` | OpenAI Agents SDK Python code |\n| `crewai` | CrewAI YAML configuration |\n| `lyzr` | Lyzr Studio agent |\n| `github` | GitHub Actions agent |\n| `git` | Git-native execution (run only) |\n| `openclaw` | OpenClaw format |\n| `nanobot` | Nanobot format |\n\n```bash\n# Export to system prompt\ngitagent export --format system-prompt\n\n# Run an agent directly\ngitagent run ./my-agent --adapter lyzr\n```\n\n## Inheritance & Composition\n\n```yaml\n# Extend a parent agent\nextends: https://github.com/org/base-agent.git\n\n# Compose with dependencies\ndependencies:\n  - name: fact-checker\n    source: https://github.com/org/fact-checker.git\n    version: ^1.0.0\n    mount: agents/fact-checker\n```\n\n## Examples\n\nSee the `examples/` directory:\n\n- **`examples/minimal/`** — 2-file hello world (agent.yaml + SOUL.md)\n- **`examples/standard/`** — Code review agent with skills, tools, and rules\n- **`examples/full/`** — Production compliance agent with all directories, hooks, workflows, sub-agents, and regulatory artifacts\n- **`examples/gitagent-helper/`** — Helper agent that assists with creating gitagent definitions\n- **`examples/lyzr-agent/`** — Example Lyzr Studio integration\n\n## Specification\n\nFull specification at [`spec/SPECIFICATION.md`](spec/SPECIFICATION.md).\n\nJSON Schemas for validation at `spec/schemas/`.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}