This is the CartSnitch organization health repository. It contains organization-wide configuration, company metadata, agent definitions, and shared skills.
- Organization Profile: Public-facing profile at
profile/README.md - Company Metadata: Internal company information at
company/ - Agent Definitions: Paperclip agent configurations at
company/agents/ - Shared Skills: Reusable skills at
company/skills/ - Dependency Management: Renovate configuration at
renovate-config.json
.github/
├── profile/
│ ├── README.md # Organization public profile (shown on github.com/cartsnitch)
│ └── cartsnitch-logo.png # Organization logo
├── company/
│ ├── README.md # Company overview and agent/skill inventory
│ ├── .paperclip.yaml # Paperclip configuration (agents, skills, company settings)
│ ├── agents/ # Per-agent configuration and instructions
│ │ ├── <agent-name>/
│ │ │ ├── AGENTS.md # Agent-specific instructions
│ │ │ ├── MEMORY.md # Agent memory/knowledge base
│ │ │ └── ... # Agent-specific files (life/, memory/, etc.)
│ └── skills/ # Shared skill definitions
│ ├── farhoodliquor/ # Third-party skills (playwright-ephemeral, shannon, github-app-token)
│ ├── fluxcd/ # Flux CD skills (gitops-knowledge, gitops-repo-audit)
│ ├── minimax-ai/ # MiniMax AI skills
│ └── paperclipai/ # Paperclip platform skills (paperclip, para-memory-files, etc.)
├── renovate-config.json # Renovate dependency update configuration
└── cartsnitch-logo.png # Organization logo (also in profile/)
The profile/README.md is displayed on the CartSnitch GitHub organization page at https://github.com/cartsnitch. It includes:
- Organization branding and logo
- Links to key repositories
- Tech stack overview
- Getting started information for developers
This file defines:
- All agents in the CartSnitch organization (role, capabilities, adapter config, runtime settings)
- Company branding settings (brand color, logo)
- Agent sidebar ordering
Each agent has its own folder containing:
AGENTS.md- Agent-specific instructions and role definitionMEMORY.md- Agent's persistent knowledge base- Additional agent-specific files (heartbeat configs, github settings, etc.)
Shared skills are organized by source:
farhoodliquor/- Third-party skills from Farhood Liquorfluxcd/- Flux CD operational skillsminimax-ai/- MiniMax AI capabilitiespaperclipai/- Paperclip platform skills
Agent configurations are defined in company/.paperclip.yaml. To update an agent:
- Edit the agent section in
.paperclip.yaml - Update the agent's
AGENTS.mdfile if role/capabilities changed - Submit changes via PR following the contribution guidelines
New agents should be added to company/.paperclip.yaml with:
- Unique agent name
- Role (engineer, qa, ceo, cto, cmo)
- Icon selection
- Capabilities description
- Adapter configuration
- Runtime settings (heartbeat interval, max concurrent runs)
- Required environment inputs
Skills are imported from external sources:
paperclipai/*skills are sourced from the Paperclip repositoryfluxcd/*skills are sourced from the Flux CD agent-skills repositoryfarhoodliquor/*skills are sourced from Farhood Liquor skills repositoryminimax-ai/*skills are sourced from MiniMax AI skills repository
To add or update a skill, edit company/.paperclip.yaml and ensure the skill files exist in the appropriate company/skills/ subdirectory.
The renovate-config.json defines dependency update behavior for all CartSnitch repositories. Updates are automated via Mend Renovate with:
- Weekly schedule (Monday before 7am)
- Auto-merge enabled for minor/patch updates
- Manual review required for major updates
- Grouped updates for related packages (ESLint, TypeScript, testing, Docker, Kubernetes)
| Repository | Purpose |
|---|---|
| cartsnitch | Main application and consumer interface |
| api | Backend API and services |
| common | Shared libraries and utilities |
| infra | Infrastructure and deployment |
| receiptwitness | Receipt parsing and processing |