docs: add foundational philosophy document - #93
Conversation
Extract the axiom-level stance of thin-supervisor into its own doc so the "why" is separable from the README's derived design principles. - docs/PHILOSOPHY.md: core axiom (worker is strong), three jobs (stop / continue / judge), capability-vs-position distinction, why we gate but never orchestrate, via negativa list - README.md: one-line pointer at the top of Design Philosophy section
|
Warning Rate limit exceeded
Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 2 minutes and 26 seconds. ⌛ How to resolve this issue?After the wait time has elapsed, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout. Please see our FAQ for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (2)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![devin-ai-integration[bot]](https://avatars.githubusercontent.com/in/811515?s=60&v=4){kind=small}
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request introduces a new documentation file, docs/PHILOSOPHY.md, which outlines the core design principles of the thin-supervisor project, emphasizing its role as a passive validator rather than an active orchestrator. A link to this new document was also added to the README.md. The feedback suggests translating the new philosophy document into English to maintain consistency with the rest of the project's documentation.
| @@ -0,0 +1,95 @@ | |||
| # thin-supervisor 的哲学 | |||
There was a problem hiding this comment.
The project's primary documentation (e.g., README.md, docs/ARCHITECTURE.md, docs/getting-started.md) is written in English, and the PR title/description are also in English. However, this new foundational philosophy document is written in Chinese. To maintain consistency and ensure accessibility for all contributors, please consider providing an English version of this document or translating it to match the rest of the documentation.
1 participant
Summary
docs/PHILOSOPHY.md(core axiom: worker is strong; three jobs: stop / continue / judge; capability-vs-position distinction; why we gate but never orchestrate; via negativa)Why
The README's "Design Philosophy" section today lists 5 implementation-level principles (memory, surface, primitives, verification, skill evolution). These are derived design rules. The axiom underneath them — why thin-supervisor watches but does not orchestrate — was never spelled out. This doc does that, and keeps it at a level that survives implementation churn.
Test plan
docs/PHILOSOPHY.md