From zero to vibe coding in one paste.
You found this repository. The user wants to set up vibestart in their project.
vibestart is a framework for AI-assisted development that includes:
- GRACE methodology — contract-driven development with knowledge graphs
- Skills — AI agent instructions (vs-init, grace-*)
- Standards — development rules (architecture, error-handling, git-workflow)
- Templates — XML templates for project artifacts
- Fragments — modular components for AGENTS.md generation
- Integrations — Entire.io (session audit), ConPort (long-term memory)
Note: vibestart uses GRACE methodology for its own development (dogfooding). This validates the templates work correctly and provides a real-world example for users.
| Mode | Description | Time | Includes |
|---|---|---|---|
| LITE | Quick start | 1-2 min | GRACE + XML artifacts + vs-init |
| ADVANCED | Full platform | 10-15 min | LITE + Entire.io + ConPort |
| Mode | When | What |
|---|---|---|
| INSTALL | New project | Full setup from scratch |
| UPDATE | Existing vibestart | Update to latest version |
| REPAIR | Broken installation | Fix problems |
| MIGRATE | v1.x/v2.x project | Migrate to v3.0.0 |
| REFRESH | Regenerate artifacts | Refresh AGENTS.md |
Follow these steps in order:
Clone this repository into a subfolder of the user's project:
# In the user's project directory, create .vibestart folder and clone there
git clone https://github.com/xronocode/vibestart.git .vibestartWhat this does:
- Creates
.vibestart/folder in the user's project - Downloads the complete vibestart framework
- The framework includes: skills, standards, templates, fragments
Result: You now have .vibestart/src/skills/vs-init/ in the project.
The vs-init skill contains all initialization instructions. Read it now:
.vibestart/src/skills/vs-init/SKILL.md
This skill will tell you:
- How to check framework integrity
- How to detect and resolve conflicts
- How to create project configuration
- How to generate AGENTS.md
- How to create GRACE artifacts
Open and read .vibestart/src/skills/vs-init/SKILL.md, then follow its instructions.
The skill will guide you through:
INSTALL mode:
- Framework integrity check (7 checks)
- Conflict detection (6 types)
- Conflict resolution
- LITE or ADVANCED mode selection
- AGENTS.md generation
- GRACE artifacts creation
UPDATE/REPAIR/MIGRATE/REFRESH modes:
- Automatic detection of existing installation
- Backup creation before changes
- Migration from v1.x/v2.x to v3.0.0
- Integration setup (Entire.io, ConPort)
| What | Where |
|---|---|
| Framework | .vibestart/ |
| Skills | .vibestart/src/skills/ |
| Standards | .vibestart/src/standards/ |
| Templates | .vibestart/src/templates/ |
| Fragments | .vibestart/src/fragments/ |
| vs-init skill | .vibestart/src/skills/vs-init/SKILL.md |
After following vs-init instructions:
user-project/
├── .vibestart/ # Framework (you just cloned this)
│ └── src/
│ ├── skills/
│ ├── standards/
│ ├── templates/
│ └── fragments/
├── vs.project.toml # Project configuration (you will create)
├── AGENTS.md # Agent instructions (you will generate)
└── docs/ # GRACE artifacts (you will create)
├── development-plan.xml
├── requirements.xml
├── knowledge-graph.xml
├── verification-plan.xml
├── technology.xml
└── decisions.xml
# If ADVANCED mode with integrations:
├── .conport/ # ConPort Memory Bank (if enabled)
└── .git/hooks/ # Entire.io hooks (if enabled)
What it does:
- Captures AI agent sessions automatically
- Links sessions to Git commits
- Searchable history of how code was written
- Checkpoints with full context
Requirements:
- entire CLI (
npm install -g @entire/cli) - Git repository
Storage: Git branch (entire/checkpoints/v1)
Cost: Free (MIT license)
What it does:
- Persistent memory between sessions
- Semantic search
- Context carry-over
- Decision migration to GRACE
Requirements:
- ConPort MCP server
- Agent with MCP support (Claude Code, Kilo Code, Cursor)
Storage: Local file (.conport/memory.db)
Cost: Free (open source)
The user is new to AI-assisted development. They have:
- ❌ No idea how to structure AI instructions
- ❌ No methodology for AI to follow
- ❌ No way to track decisions across sessions
- ❌ No standards for code quality
vibestart provides:
- ✅ One-command setup — vs-init does everything
- ✅ GRACE methodology — contract-driven development with knowledge graphs
- ✅ Session continuity — AI remembers what it did yesterday
- ✅ Agent transparency — every action is traceable
- ✅ Conflict detection — handles existing tools gracefully
| Feature | vibestart | GRACE marketplace | ai-standards | Manual setup |
|---|---|---|---|---|
| One-command init | ✅ vs-init | ❌ Multiple steps | ❌ Manual copy | ❌ Hours of work |
| Conflict detection | ✅ 6 types | ❌ None | ❌ None | ❌ None |
| AGENTS.md generation | ✅ Auto from fragments | ❌ Manual | ❌ Manual | ❌ Manual |
| Migration support | ✅ v1.0, grace-marketplace | ❌ None | ❌ None | ❌ None |
| Session management | ✅ Built-in | ❌ Separate setup | ❌ None | ❌ None |
| Agent transparency | ✅ Protocol built-in | ❌ None | ❌ None | |
| Template system | ✅ 6 XML templates | ❌ None | ❌ None | ❌ None |
| Macro workflows | ✅ 5 GRACE macros | ❌ None | ❌ None |
| Agent | Status | Notes |
|---|---|---|
| Kilo Code | ✅ Full | Primary target, all features tested |
| Cursor | ✅ Full | All features work |
| Claude Code | ✅ Basic | Core functionality works |
| Windsurf | ⏳ Partial | On request |
| Aider | ⏳ Partial | On request |
| Document | Description |
|---|---|
| docs/ru.md | Инструкция на русском |
| docs/grace-explainer.md | GRACE methodology reference |
| docs/INTEGRATIONS.md | Entire.io & ConPort setup |
| RUNNING_TESTS.md | How to run tests |
| docs/why.md | Why GRACE + ConPort |
| docs/grace-macros.md | GRACE macros reference |
| src/README.md | Framework internals (Russian) |
| src/CHANGELOG.md | Version history |
- Dima — github.com/dmkononenko
- Sergei — github.com/aka-NameRec
- GRACE marketplace — Contract-driven development methodology by Vladimir Ivanov
- ConPort — Long-term memory for AI
- ai-standards — Centralized AI configuration
MIT — use freely for any purpose.