docs: comprehensive README with skills & knowledge guide

- 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 aa466ffcfd
commit 78b5fce74a
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