docs: comprehensive README with skills & knowledge guide
ci / test (push) Successful in 1m50s

- Explain Poimen philosophy (shepherd metaphor for orchestration)
- Document architecture and data flow with visual diagrams
- List all 9 registered activities with knowledge specs
- Provide getting started guide and usage patterns
- Include CI/CD pipeline, troubleshooting, and roadmap
- Integrate skills registration guide for contributors
- Explain registerable knowledge types (activity, domain, patterns)
- Document CRAP score improvements (97% reduction)
- Create virtuous cycle explanation (self-improving system)
- Add .gitignore exception for README.md

Refs: Shepherd metaphor emphasizes learning, adaptation, and composition
over rigid task scheduling. Each registered skill teaches the system.
This commit is contained in:
Test
2026-09-03 13:58:33 -07:00
parent e8984b055c
commit 86ad8e7b5e
4 changed files with 750 additions and 3 deletions
+2 -1
View File
@@ -1,5 +1,6 @@
# Ignore markdown docs except agent-prompts
# Ignore markdown docs except agent-prompts and README
*.md
!README.md
!agent-prompts/*.md
!agent-prompts/**/*.md
# Binaries