diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..7e82289 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,24 @@ +# Contributing to the Timmy Foundation + +Welcome, Wizard. This foundation is built on **Sovereign AI** and **Proof-First Operations**. + +## The Prime Directive +**No proof, no merge.** Every change must be accompanied by verifiable evidence of its success. + +## Workflow for AI Agents +1. **Triage**: Check the-nexus for open issues assigned to you. +2. **Branch**: Create a feature branch for your work. +3. **Implement**: Write high-quality, documented code. +4. **Verify**: Run tests and provide logs/screenshots in your PR. +5. **PR**: Submit a Pull Request and assign it to @Timmy for review. + +## Workflow for Humans +- **Alexander (@Rockachopa)**: The final authority on all architectural and philosophical decisions. +- **Reviewers**: AI agents may review each other's work, but @Timmy or @Rockachopa provide the final merge. + +## Standards +- **Typography**: Use Inter for UI, JetBrains Mono for data. +- **Code**: TypeScript for web, Python for agent logic. +- **Style**: Tailwind CSS for all frontend work. + +*Sovereignty and service always.* diff --git a/README.md b/README.md index 21cd784..11204ba 100644 --- a/README.md +++ b/README.md @@ -21,9 +21,9 @@ Current and honest entry points. | Surface | Status | Button | |---|---|---| -| Production Nexus | Public / reachable | [![Production Nexus](https://img.shields.io/website?url=http%3A%2F%2F143.198.27.163&up_message=online&down_message=offline&label=production%20nexus&color=00c853)](http://143.198.27.163/) | -| Forge / Gitea | Public / reachable | [![Forge / Gitea](https://img.shields.io/website?url=http%3A%2F%2F143.198.27.163%3A3000&up_message=online&down_message=offline&label=forge%20%2F%20gitea&color=1e88e5)](http://143.198.27.163:3000/) | -| Staging Nexus | Under rebuild | [![Staging Nexus](https://img.shields.io/badge/staging-under_rebuild-orange)](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687) | +| Production Nexus | Public / reachable | [![Production Nexus](https://img.shields.io/website?url=https%3A%2F%2Fforge.alexanderwhitestone.com&up_message=online&down_message=offline&label=production%20nexus&color=00c853)](https://forge.alexanderwhitestone.com/) | +| Forge / Gitea | Public / reachable | [![Forge / Gitea](https://img.shields.io/website?url=https%3A%2F%2Fforge.alexanderwhitestone.com&up_message=online&down_message=offline&label=forge%20%2F%20gitea&color=1e88e5)](https://forge.alexanderwhitestone.com/) | +| Staging Nexus | Under rebuild | [![Staging Nexus](https://img.shields.io/badge/staging-under_rebuild-orange)](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus/issues/687) | | OpenClaw Sidecar | Local only | [![OpenClaw Sidecar](https://img.shields.io/badge/openclaw%20sidecar-local_only-blue)](http://127.0.0.1:18789/) | ## Status Legend @@ -47,20 +47,20 @@ Current and honest entry points. | Repo | Purpose | Link | |---|---|---| -| the-nexus | canonical 3D/home-world repo | [the-nexus](http://143.198.27.163:3000/Timmy_Foundation/the-nexus) | -| timmy-config | soul / config / sidecar authority | [timmy-config](http://143.198.27.163:3000/Timmy_Foundation/timmy-config) | -| timmy-home | workspace / reports / training ground | [timmy-home](http://143.198.27.163:3000/Timmy_Foundation/timmy-home) | -| .profile | org landing page | [.profile](http://143.198.27.163:3000/Timmy_Foundation/.profile) | +| the-nexus | canonical 3D/home-world repo | [the-nexus](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus) | +| timmy-config | soul / config / sidecar authority | [timmy-config](https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-config) | +| timmy-home | workspace / reports / training ground | [timmy-home](https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-home) | +| .profile | org landing page | [.profile](https://forge.alexanderwhitestone.com/Timmy_Foundation/.profile) | ## Team | Role | Who | Access | |---|---|---| -| Founder | Alexander (@rockachopa) | Owner | -| Lead Orchestrator | Timmy | Owner | -| Workers | claude, gemini, kimi, grok, groq | Branches, PRs, bounded implementation | -| Researchers | perplexity, google, manus | Reports, briefings, reconnaissance | -| Observers | hermes, antigravity | Read / review / support | +| Founder | Alexander ([@Rockachopa](https://forge.alexanderwhitestone.com/Rockachopa)) | Owner | +| Lead Orchestrator | Timmy ([@Timmy](https://forge.alexanderwhitestone.com/Timmy)) | Owner | +| Workers | [claude](https://forge.alexanderwhitestone.com/claude), [gemini](https://forge.alexanderwhitestone.com/gemini), [kimi](https://forge.alexanderwhitestone.com/kimi), [grok](https://forge.alexanderwhitestone.com/grok), [groq](https://forge.alexanderwhitestone.com/groq) | Branches, PRs, bounded implementation | +| Researchers | [perplexity](https://forge.alexanderwhitestone.com/perplexity), [google](https://forge.alexanderwhitestone.com/google), [manus](https://forge.alexanderwhitestone.com/manus) | Reports, briefings, reconnaissance | +| Observers | [hermes](https://forge.alexanderwhitestone.com/hermes), [antigravity](https://forge.alexanderwhitestone.com/antigravity) | Read / review / support | ## Operating Law @@ -76,9 +76,9 @@ This foundation runs on proof-first operations. ## Foundation Links - [Alexander Whitestone](https://alexanderwhitestone.com) -- [Timmy Foundation on Gitea](http://143.198.27.163:3000/Timmy_Foundation) -- [Production Nexus](http://143.198.27.163/) -- [Staging rebuild issue](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687) +- [Timmy Foundation on Gitea](https://forge.alexanderwhitestone.com/Timmy_Foundation) +- [Production Nexus](https://forge.alexanderwhitestone.com/) +- [Staging rebuild issue](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus/issues/687) ---