{"id":50965633,"url":"https://github.com/snakeying/textum","last_synced_at":"2026-06-18T20:01:41.414Z","repository":{"id":331681977,"uuid":"1126378062","full_name":"snakeying/Textum","owner":"snakeying","description":"Structured workflow that stops AI from forgetting your requirements. 4 phases with validation gates. Not smarter AI, just controllable process. Weave ideas into code that actually works.","archived":false,"fork":false,"pushed_at":"2026-01-17T21:47:32.000Z","size":721,"stargazers_count":39,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-18T08:08:11.116Z","etag":null,"topics":["claude-code","claude-skill","codex","codex-skill","skills","vibe-coding"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/snakeying.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-01T19:31:34.000Z","updated_at":"2026-01-18T04:40:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/snakeying/Textum","commit_stats":null,"previous_names":["snakeying/textum"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/snakeying/Textum","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snakeying%2FTextum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snakeying%2FTextum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snakeying%2FTextum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snakeying%2FTextum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/snakeying","download_url":"https://codeload.github.com/snakeying/Textum/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snakeying%2FTextum/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34505423,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","claude-skill","codex","codex-skill","skills","vibe-coding"],"created_at":"2026-06-18T20:01:40.377Z","updated_at":"2026-06-18T20:01:41.403Z","avatar_url":"https://github.com/snakeying.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n🕸️ Textum\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eWeave your ideas into runnable code\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  A workflow that helps AI make fewer mistakes \u003cbr/\u003e\n  \u003cem\u003eNot by making AI smarter, but by making the process more controllable\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cbr\u003e English | \u003ca href=\"README_CN.md\"\u003e中文\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e ⚠️ **Note**: The old commands version is deprecated and no longer supported. Only the skill version is currently supported.\n\n## 🤔 What's this all about?\n\nEver run into these problems?\n\n- 💬 You spend ages explaining requirements to AI, only for it to forget what you said halfway through\n- 🔄 One tiny requirement change and suddenly you're rewriting everything\n- 🎲 Every generation is a roll of the dice — quality is pure luck\n\n**That's exactly what Textum is here to fix.**\n\nIt won't make AI any smarter, but through **structured workflow and validation**, it helps AI avoid the kind of mistakes that shouldn't happen in the first place.\n\n---\n\n## ✨ How does it work?\n\nJust describe your idea in plain language. Textum breaks the whole thing down into 4 phases:\n\n### Step 1: 📝 Requirements Clarification (PRD)\n\u003e \"So, what are we building?\"\n\nAI chats with you to turn fuzzy ideas into a clear requirements doc.\nEvery feature gets a number (like FEATURE-001) — no more repeating yourself later.\n\n### Step 2: 🏗️ Technical Decisions (Scaffold)\n\u003e \"What's the tech stack? How do we structure this?\"\n\nLock down the architecture, pick your technologies, define the modules.\nThis creates a \"global context\" that keeps all the coding consistent.\n\n### Step 3: 🧩 Task Breakdown (Split)\n\u003e \"What's the game plan?\"\n\nBreak requirements into bite-sized tasks (Stories) — think sticky notes.\nOne Story, one job. Finish it, then move on.\n\n### Step 4: 💻 Code Implementation (Story)\n\u003e \"Let's write some code!\"\n\nAI tackles one Story at a time, laser-focused without distractions.\nEach Story gets validated when done — no drifting off course.\n\n\u003e ⚠️ **Experimental**: `Story Full Exec` supports batch execution of multiple Stories (sequential, no rollback). This feature is experimental — use at your own discretion. ⚠️\n\n---\n\n## 🎯 Why all these steps?\n\nPicture this: you hand AI a 10-page requirements doc and say \"build it all.\"\nWhat happens?\n\nBy feature #5, AI has already forgotten what fields were in feature #1. 😅\n\n**It's not that AI is dumb — it just has limited \"memory.\"** The more info you throw at it, the easier it loses track.\n\nThat's why Textum's philosophy is simple: **Less is more**\n\n| The Old Way | The Textum Way |\n|-------------|----------------|\n| Dump all requirements on AI at once | 📦 Feed it phase by phase, only what's needed now |\n| Keep saying \"you know, that login API thing\" | 🔗 Just say API-001 — short and unambiguous |\n| One requirement change = regenerate everything | 🎯 Only regenerate what's actually affected |\n\n---\n\n## 📏 What kind of projects work best?\n\n| Project Size | Feature Count | What to Expect | Examples |\n|--------------|---------------|----------------|----------|\n| 🌱 Small | 10-15 | ✅ Solid results | Expense tracker, todo app, personal notes |\n| 🌿 Medium | 15-25 | ✅ Solid results | Simple blog, survey system |\n| 🌳 Larger | 25-35 | ⚠️ Needs human review | Multi-role admin panel, booking platform |\n\n\u003e 💡 **Even bigger?** Split it into independent sub-projects and run each through Textum separately.\n\n**Simulation Test Reports**\n\nSKILL version test reports:\n- [1.0](./simulate-test-reports/e2e-run-1.0_EN.md)\n- [1.1](./simulate-test-reports/e2e-run-1.1_EN.md)\n- [1.3](./simulate-test-reports/e2e-run-1.3_EN.md)\n- [1.5](./simulate-test-reports/e2e-run-1.5_EN.md)\n\n⚠️ (Tests below are based on the old commands version using Claude Opus 4.5. Note: commands version is deprecated, for reference only)\n- [V2](./simulate-test-reports/v2simulate-test-report-opus_EN.md) | [V3](./simulate-test-reports/v3simulate-test-report-opus_EN.md) | [V4](./simulate-test-reports/v4simulate-test-report-opus_EN.md)\n- [V5](./simulate-test-reports/v5simulate-test-report-opus_EN.md) (complexity ramps up from V5) | [V6](./simulate-test-reports/v6simulate-test-report-opus_EN.md) | [Beta](./simulate-test-reports/beta-simulate-test-report-opus_EN.md)\n\n### ❌ When Textum isn't the right fit\n\n- **Need it done yesterday**: Textum takes time to run through the workflow — not great for \"hotfix and ship NOW\"\n- **Dead simple tasks**: Like \"make this button red\" — just do it, don't overthink it\n- **No idea what you want**: If you can't describe it, Textum can't help 😅\n\n---\n\n## 🚀 Getting Started\n\n### 1️⃣ Install uv\n\n```bash\n# macOS and Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Windows\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n\n# Or via package manager\nbrew install uv  # macOS\npip install uv   # any platform\n```\n\n\u003e 💡 **What's uv?** A blazing-fast Python package manager (think npm, but for Python)\n\n### 2️⃣ Initialize the project\n\nIn your project root:\n\n```bash\n# For Codex users\nuv sync --project .codex/skills/textum/scripts\n\n# For Claude Code users\nuv sync --project .claude/skills/textum/scripts\n```\n\n✅ This automatically:\n- Checks your Python version (needs \u003e= 3.11)\n- Creates an isolated virtual environment (keeps your project clean)\n- Installs all dependencies\n\n### 3️⃣ Start building\n\nFire up your AI assistant (Codex/Claude Code) and say:\n\n\u003e \"I want to start a new project with Textum\"\n\nAI will walk you through the rest 🎯\n\n👉 **Want the technical deep-dive?** Check out [Workflow](./Workflow.md)\n\n---\n\n## 🕸️ Why \"Textum\"?\n\n\u003e *\"The Machine's true power was never in any single judgment, but in weaving scattered people, events, and time into a web.\"*\n\u003e — A tribute to *Person of Interest*\n\nOn their own, individual pieces of information mean nothing. Woven together, patterns emerge.\n\n**Textum** is Latin for \"something woven into a whole.\" That's exactly what this project does: it doesn't create intelligence — it weaves requirements, context, and storylines together.\n\nOnce the web is complete, the path forward reveals itself.\n\n---\n\n## 🙏 Found it useful?\n\n- ⭐ **Star the repo** — Help others find it\n- 🐛 **Open an Issue** — Let me know what could be better\n- 💬 **Share your story** — Might turn it into a case study\n\nThanks! 🎉\n\n---\n\n## 📜 License\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n[![Star History Chart](https://api.star-history.com/svg?repos=snakeying/Textum\u0026type=Date)](https://star-history.com/#snakeying/Textum\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnakeying%2Ftextum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsnakeying%2Ftextum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnakeying%2Ftextum/lists"}