Weave your ideas into runnable code
A workflow that helps AI make fewer mistakes
Not by making AI smarter, but by making the process more controllable
English | 中文
⚠️ Note: The old commands version is deprecated and no longer supported. Only the skill version is currently supported.
Ever run into these problems?
- 💬 You spend ages explaining requirements to AI, only for it to forget what you said halfway through
- 🔄 One tiny requirement change and suddenly you're rewriting everything
- 🎲 Every generation is a roll of the dice — quality is pure luck
That's exactly what Textum is here to fix.
It 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.
Just describe your idea in plain language. Textum breaks the whole thing down into 4 phases:
"So, what are we building?"
AI chats with you to turn fuzzy ideas into a clear requirements doc. Every feature gets a number (like FEATURE-001) — no more repeating yourself later.
"What's the tech stack? How do we structure this?"
Lock down the architecture, pick your technologies, define the modules. This creates a "global context" that keeps all the coding consistent.
"What's the game plan?"
Break requirements into bite-sized tasks (Stories) — think sticky notes. One Story, one job. Finish it, then move on.
"Let's write some code!"
AI tackles one Story at a time, laser-focused without distractions. Each Story gets validated when done — no drifting off course.
⚠️ Experimental:Story Full Execsupports batch execution of multiple Stories (sequential, no rollback). This feature is experimental — use at your own discretion.⚠️
Picture this: you hand AI a 10-page requirements doc and say "build it all." What happens?
By feature #5, AI has already forgotten what fields were in feature #1. 😅
It's not that AI is dumb — it just has limited "memory." The more info you throw at it, the easier it loses track.
That's why Textum's philosophy is simple: Less is more
| The Old Way | The Textum Way |
|---|---|
| Dump all requirements on AI at once | 📦 Feed it phase by phase, only what's needed now |
| Keep saying "you know, that login API thing" | 🔗 Just say API-001 — short and unambiguous |
| One requirement change = regenerate everything | 🎯 Only regenerate what's actually affected |
| Project Size | Feature Count | What to Expect | Examples |
|---|---|---|---|
| 🌱 Small | 10-15 | ✅ Solid results | Expense tracker, todo app, personal notes |
| 🌿 Medium | 15-25 | ✅ Solid results | Simple blog, survey system |
| 🌳 Larger | 25-35 | Multi-role admin panel, booking platform |
💡 Even bigger? Split it into independent sub-projects and run each through Textum separately.
Simulation Test Reports
SKILL version test reports:
- Need it done yesterday: Textum takes time to run through the workflow — not great for "hotfix and ship NOW"
- Dead simple tasks: Like "make this button red" — just do it, don't overthink it
- No idea what you want: If you can't describe it, Textum can't help 😅
# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Or via package manager
brew install uv # macOS
pip install uv # any platform💡 What's uv? A blazing-fast Python package manager (think npm, but for Python)
In your project root:
# For Codex users
uv sync --project .codex/skills/textum/scripts
# For Claude Code users (🚧 Coming soon)
uv sync --project .claude/skills/textum/scripts✅ This automatically:
- Checks your Python version (needs >= 3.11)
- Creates an isolated virtual environment (keeps your project clean)
- Installs all dependencies
Fire up your AI assistant (Codex/Claude Code) and say:
"I want to start a new project with Textum"
AI will walk you through the rest 🎯
👉 Want the technical deep-dive? Check out Workflow
"The Machine's true power was never in any single judgment, but in weaving scattered people, events, and time into a web." — A tribute to Person of Interest
On their own, individual pieces of information mean nothing. Woven together, patterns emerge.
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.
Once the web is complete, the path forward reveals itself.
- ⭐ Star the repo — Help others find it
- 🐛 Open an Issue — Let me know what could be better
- 💬 Share your story — Might turn it into a case study
Thanks! 🎉
