Multi-category artifact platform for the Phenotype software organization.
PhenoKits organizes artifacts into 12 distinct categories, each with clear mutability rules and agent interaction patterns.
| # | Category | Purpose | Mutability |
|---|---|---|---|
| 1 | templates/ |
Scaffolding for new projects | Editable |
| 2 | configs/ |
Parameterized configs | Parameters only |
| 3 | libs/ |
Multi-language libraries | Import/extend |
| 4 | secrets/ |
Secret management patterns | Locked |
| 5 | governance/ |
ADRs, RFCs, standards | Varies |
| 6 | security/ |
Scanning, policies, hardening | Locked |
| 7 | observability/ |
Logging, metrics, tracing | Configurable |
| 8 | docs/ |
API docs, runbooks, guides | Editable |
| 9 | scripts/ |
Build, release, quality scripts | Executable |
| 10 | schemas/ |
Type definitions, API specs | Locked |
| 11 | policies/ |
OPA, GitHub, compliance | Enforced |
| 12 | credentials/ |
Auth configs, patterns | Locked |
| Category | Agent Reads | Agent Writes | Agent Enforces |
|---|---|---|---|
| Templates | Yes | Yes (instantiation) | No |
| Configs | Yes | Parameters only | Yes (validation) |
| Libs | Yes | No | No |
| Secrets | Yes | No | No |
| Governance | Yes | Yes (ADRs) | No |
| Security | Yes | Yes | Yes (scanning) |
| Observability | Yes | Yes | Yes (monitoring) |
| Docs | Yes | Yes | No |
| Scripts | Yes | Yes | No |
| Schemas | Yes | Yes (code gen) | Yes (type checking) |
| Policies | Yes | Yes | Yes (OPA, gates) |
| Credentials | Yes | No | Yes (rotation) |
PhenoKits/
├── templates/ # 1. Scaffolding
│ ├── hexagonal/ # Hexagonal architecture templates
│ ├── clean-rust/ # Clean architecture Rust template
│ └── phenotype-api/ # Phenotype API template
├── configs/ # 2. Parameterized configs
│ ├── tooling/ # Linters, formatters
│ ├── cicd/ # CI/CD pipelines
│ ├── infra/ # Docker, Kubernetes
│ └── observability/ # Prometheus, Grafana
├── libs/ # 3. Libraries
│ ├── rust/ # Canonical Rust cores
│ ├── python/ # Python bindings
│ ├── typescript/ # TypeScript bindings
│ └── go/ # Go bindings
├── secrets/ # 4. Secret management
├── governance/ # 5. ADRs, RFCs, standards
├── security/ # 6. Security configs
├── observability/ # 7. Logging, metrics
├── docs/ # 8. Documentation
├── scripts/ # 9. Automation scripts
├── schemas/ # 10. Type definitions
├── policies/ # 11. Enforcement policies
└── credentials/ # 12. Auth configs
# 1. Clone PhenoKits
git clone https://github.com/KooshaPari/PhenoKits.git
cd PhenoKits
# 2. Read agent patterns
cat docs/AGENT_PATTERNS.md
# 3. Apply a config
python3 scripts/utility/parameterize.py \
configs/params.example.json \
configs/cicd/github-actions/ci.yml
# 4. Scaffold a project
pheno new --template hexagonal-rust --name my-service --org MyOrg# 1. Apply org configs
cp -r configs/tooling/pre-commit/* .git/hooks/
# 2. Set up CI
cp configs/cicd/github-actions/* .github/workflows/
# 3. Configure observability
cp configs/observability/prometheus.yml ./- RESTRUCTURING_PLAN.md - Full restructuring plan
- RESTRUCTURING_ADR.md - Decision record
- AGENT_PATTERNS.md - Agent consumption patterns
- HexaKit/ - Template CLI and registry
- PhenoKit - Core SDK
- PhenoSpecs - Specifications