Skip to content

Commit ad3aec2

Browse files
Delete examples/ - doesn't belong in framework repository
Problem: - examples/task-manager/ contained only ideation docs + tutorial - No actual generated code - Misleading - promised working app but was just documentation - Doesn't belong in framework repo (this is the framework, not showcase) What was deleted: - examples/task-manager/ideation/vision.md (191 lines) - examples/task-manager/ideation/features.md (265 lines) - examples/task-manager/README.md (310 lines tutorial) - Total: 766 lines of unnecessary content Changes: - Removed examples/ directory entirely - Updated README.md - changed Examples section to "Coming Soon" - Updated CLAUDE.md - removed examples reference - Updated CONTRIBUTING.md - use /tmp for testing instead - Updated docs/about/USE-CASES.md - removed broken references - Updated docs/guides/04-WRITING-IDEATION.md - use inline examples - Updated docs/reference/implementation-guide.md - removed Phase 4 Rationale: The framework repository should contain ONLY framework code: - CLI - Agents - Templates - Documentation Example projects belong in separate showcase repository where they can be built WITH AgentCodeX and maintained independently. Repository is now clean and focused on framework only. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 100c60c commit ad3aec2

File tree

9 files changed

+40
-850
lines changed

9 files changed

+40
-850
lines changed

CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -410,7 +410,7 @@ The framework itself (this repo) is Node.js/JavaScript.
410410
- See [docs/getting-started/](docs/getting-started/) for quick start
411411
- See [docs/reference/](docs/reference/) for technical documentation
412412
- **Issues:** Report bugs at https://github.com/ScaledMinds/AgentCodeX/issues
413-
- **Examples:** See `examples/` for complete project examples
413+
- **Examples:** Coming soon in separate showcase repository
414414
- **Agent Behavior:** Read agent files in `.claude/agents/` to understand what they do
415415

416416
## Anti-Patterns to Avoid

CONTRIBUTING.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -138,8 +138,9 @@ agentcodex start
138138
```bash
139139
# Make changes to .claude/agents/*.md
140140

141-
# Test with actual project
142-
cd examples/task-manager
141+
# Test with actual project in separate directory
142+
mkdir -p /tmp/test-project/ideation
143+
# Create test ideation files
143144
# Spawn MAESTRO in Claude Code
144145
```
145146

README.md

Lines changed: 4 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -285,30 +285,12 @@ After 10 projects with cumulative 10%+ improvement → **AgentCodeX v2.1 release
285285

286286
## 📚 Examples
287287

288-
### Task Manager SaaS
289-
290-
Full example in `examples/task-manager/`
291-
292-
**Features:**
293-
294-
- AI natural language task creation
295-
- Team collaboration
296-
- Real-time sync
297-
- Smart prioritization
298-
299-
**Build time:** 45 minutes
300-
**Lines of code:** 8,500
301-
**Files created:** 127
302-
**Test coverage:** 95.3%
303-
304-
[See full example →](examples/task-manager/)
305-
306-
### More Examples (Coming Soon)
307-
288+
**Coming Soon:**
289+
- Complete example projects in separate showcase repository
308290
- E-commerce platform
309291
- CRM system
310292
- Analytics dashboard
311-
- Social media scheduler
293+
- Task management SaaS
312294

313295
---
314296

@@ -660,4 +642,4 @@ agentcodex init
660642

661643
Made with 🤖 by [BJ Urban](https://github.com/ScaledMinds)
662644

663-
[Documentation](docs/)[Examples](examples/)[Agents](.claude/agents/)[Issues](https://github.com/ScaledMinds/AgentCodeX/issues)
645+
[Documentation](docs/)[Agents](.claude/agents/)[Issues](https://github.com/ScaledMinds/AgentCodeX/issues)

docs/about/USE-CASES.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ AgentCodeX can build any modern web application that uses the V4 tech stack. Thi
8585
- **Documentation:** 15 docs
8686
- **Deployed:** https://dev.analytics-dash.com
8787

88-
**Note:** Full example coming soon in `examples/analytics-dashboard/`
88+
**Note:** Complete working examples coming soon in separate showcase repository
8989

9090
---
9191

@@ -151,7 +151,7 @@ AgentCodeX can build any modern web application that uses the V4 tech stack. Thi
151151
- **AI:** Smart priorities, deadline prediction
152152
- **Time:** ~40 minutes
153153

154-
**See:** `examples/task-manager/` for full implementation
154+
**Note:** Working example coming in separate showcase repository
155155

156156
### Internal Tools
157157

docs/guides/04-WRITING-IDEATION.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -725,24 +725,23 @@ MAESTRO will:
725725
- "Similar to Notion's editor"
726726
- Helps agents understand vision
727727

728-
## Examples from Real Projects
728+
## Examples in This Guide
729729

730-
See complete ideation examples:
730+
This guide includes inline examples for:
731+
- E-commerce Platform (see above)
732+
- Analytics Dashboard (see above)
733+
- Minimum/Standard/Comprehensive templates (see above)
731734

732-
- **[Task Manager](../../examples/task-manager/ideation/)** - Simple, effective
733-
734-
**More examples coming soon:**
735-
- E-commerce Platform - Comprehensive
736-
- Analytics Dashboard - Technical
735+
**More complete examples coming in separate showcase repository.**
737736

738737
## Need Help?
739738

740739
**Stuck on ideation?**
741740

742-
1. Look at [task-manager example](../../examples/task-manager/ideation/)
743-
2. Use templates above
741+
1. Use the templates in this guide
742+
2. Start with minimum template and expand
744743
3. Ask in [Discussions](https://github.com/ScaledMinds/AgentCodeX/discussions)
745-
4. Start simple, iterate
744+
4. Remember: even simple ideation works - iterate as you go
746745

747746
**Remember:** Even a simple vision.md works. The more detail you provide, the better the result.
748747

docs/reference/implementation-guide.md

Lines changed: 21 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -365,67 +365,41 @@ When ORACLE identifies an improvement:
365365

366366
---
367367

368-
## Phase 4: Example Project
368+
## Phase 4: Testing & Validation
369369

370-
Create a complete example project to demonstrate AgentCodeX.
370+
Test AgentCodeX with real projects.
371371

372-
### 4.1 Example Ideation
372+
### 4.1 Create Test Project
373373

374-
**File:** `examples/task-manager/ideation/vision.md`
375-
376-
```markdown
377-
# Task Manager SaaS
378-
379-
## Overview
380-
381-
A beautiful, AI-powered task management application.
382-
383-
## Features
384-
385-
- Create, edit, delete tasks
386-
- AI-powered task suggestions
387-
- Natural language task creation
388-
- Smart prioritization
389-
- Team collaboration
390-
391-
## Users
392-
393-
- Individual professionals
394-
- Small teams (2-10 people)
374+
```bash
375+
mkdir -p /tmp/test-app/ideation
376+
cd /tmp/test-app
377+
```
395378

396-
## Goals
379+
### 4.2 Write Test Ideation
397380

398-
- Launch MVP in 1 day
399-
- 95%+ test coverage
400-
- Production-ready infrastructure
401-
```
381+
Create `ideation/vision.md` with your test application idea.
402382

403-
### 4.2 Run AgentCodeX
383+
### 4.3 Run Full Build
404384

405385
```bash
406-
cd examples/task-manager
407-
agentcodex start
386+
# In Claude Code, spawn MAESTRO:
387+
# /agentcodex-start
408388
```
409389

410390
Expected outcome:
391+
- MAESTRO coordinates all agents
392+
- Complete application generated
393+
- Deployed to dev environment
394+
- ~45 minutes total
411395

412-
- MAESTRO reviews ideation
413-
- Creates PRD
414-
- Designs architecture
415-
- Builds complete application
416-
- Deploys to `dev.taskmanager.example.com`
417-
- All in ~45 minutes
418-
419-
### 4.3 Document the Process
396+
### 4.4 Document Results
420397

421398
Record:
422-
423-
- Time taken for each agent
424-
- Any errors encountered
425-
- Quality of generated code
426-
- Required human interventions
427-
428-
This becomes the showcase for AgentCodeX capabilities.
399+
- Build time
400+
- Success rate
401+
- Code quality
402+
- Any issues
429403

430404
---
431405

0 commit comments

Comments
 (0)