Diamond Theory
We first started talking about Diamond Theory more than a year ago. There were several attempts to get it off the ground, but at the time AI simply was not ready to tackle something of this scope. The tools were too shallow, the context windows too small, and the reasoning too brittle to do justice to a framework this interconnected.
Since then, we have built the EVE Framework — a comprehensive system that has its roots in work done since 2008 in the banking sector. EVE has been expanded to incorporate AI as a first-class participant: it is essentially a harness for AI, grounded in industry best practices and informed by the latest innovations in agentic architecture, context management, and autonomous workflows. The framework is still in active development, but it is nearing the point where it is fully usable and stable.
The purpose of this page is to broadly highlight some of those previous starting attempts, what has been done so far, and what currently exists in the Diamond Theory documentation library. It is not the finished product — it is the introduction.
As you read this, several AI agents are actively working behind the scenes to apply the Eve Framework to this Diamond Theory portal. By tomorrow, a fully enabled AI will have access to all the content documented below, as well as any content that users upload. It will also be able to take direct instructions from users in order to review, rectify, and confirm the specifications we currently have — turning this from a static reference into a collaborative workspace.
This is just the introduction. The rest will follow over the next few days.
Most frameworks for personal growth or governance follow a straight line: set a goal, make a plan, execute, then maybe review at the end. Diamond Theory argues this is fundamentally wrong. Life does not move in straight lines. Seasons cycle. Economies cycle. Relationships cycle. When you fight cycles, you stagnate. When you work with them, you compound growth over time.
Diamond Theory is a cyclical governance and personal development framework built on this insight. Instead of linearity, it gives you a repeating loop: reflect on where you are, plan what comes next, act on that plan while measuring what actually happens, then extract the lessons and carry them into the next round. Each completed cycle makes the next one more informed, more intentional, and more effective.
The framework operates at four nested levels (called the Four Diamonds: Grey, Red, Green, Blue) and moves through four phases (the Four A's). It is fractal by design — the same cycle that helps an individual plan a side hustle also works for a community development programme or a national policy initiative. The scale changes; the process does not.
The Four Phases (The Four A's)
The Four Diamonds
The practical workhorse. An eight-step cycle: define the task, plan it, develop the approach, implement it, assess the results, reflect on what happened, extract lessons, and build character from the experience. This is the engine that turns ideas into outcomes. Every project runs through Grey.
Community and love-centred governance. Red lifts you from self-interest to shared purpose. It is about vision-driven action, leading from service rather than fear, and balancing masculine drive with feminine intuition. Where Grey gets things done, Red asks why they matter and who they serve.
Environmental sustainability and abundance. Green treats humanity as part of nature, not its master. It reframes scarcity thinking into abundance thinking and insists that any governance model that ignores the physical environment is incomplete. Wealth that destroys the ecosystem is not wealth — it is debt.
Higher consciousness and spiritual alignment. Blue goes beyond the material and asks: what is the purpose behind the purpose? It draws on concepts of frequency, unconditional love, and interconnectedness. For some this is spiritual, for others philosophical — but the function is the same: it provides a compass when the tactical gets confusing.
Most methodologies treat reflection as an afterthought — a retrospective tacked on at the end of a sprint. Diamond Theory inverts this: reflection comes first. You cannot plan well if you have not honestly assessed where you are. You cannot learn if you do not pause to reflect before rushing into the next action.
The Theory of Opposites extends this further. Action and reflection, planning and learning, economics and ethics — these are not enemies or trade-offs. They are complementary forces that generate form through their tension, like the poles of a magnet. A framework that emphasises one at the expense of the other is structurally incomplete. Diamond holds both.
This is what distinguishes it from Lean (which emphasises eliminating waste but underweights ethics), Agile (which iterates fast but rarely asks why), Design Thinking (which empathises with users but does not reflect on values), and conventional systems thinking (which maps complexity but does not prescribe a moral dimension).
An app called Diamond A-Spire has been fully designed to embody the Diamond cycle digitally. The user creates a "diamond" — essentially a project or goal — and moves through all four phases sequentially. A literal diamond shape on screen fills progressively as each phase completes, giving a visceral sense of progress. When the diamond is full and glowing, the cycle is complete, and the user can start a new one carrying their extracted lessons forward.
The specification is comprehensive. Every screen has been wireframed, every database table has been defined down to field types and validation rules, every API endpoint has request and response schemas. There are user stories with acceptance criteria for three distinct personas. There is a security specification, an AI prompt specification for Claude-powered reflective questions, and a detailed frontend architecture. All of this totals roughly 40,000 words of production-ready documentation.
None of it has been built. The project is 100% paper, 0% code.
| Component | Status | Detail |
|---|---|---|
| Database Schema | 100% | 9 Firestore collections, all fields, types, constraints, indexes, security rules |
| API Design | 100% | 34 REST endpoints with request/response schemas, error codes, rate limiting |
| Frontend Architecture | 100% | Next.js 14 App Router, 70+ components, hooks, state management, PWA |
| Backend Architecture | 100% | Firebase Cloud Functions, auth, AI integration (Claude), SendGrid email |
| Wireframes | 100% | 10 screens with design system, responsive, animations, accessibility |
| User Stories | 100% | 3 personas, 7 epics, 30+ stories with acceptance criteria |
| Implementation | 0% | Not started — specs only |
App User Flow
2. Awareness: Answer 5 reflective questions → first diamond point fills
3. Anticipation: Create plan with budget, timeline, milestones → second point fills
4. Accountability: Log progress, track actual vs planned → third point fills
5. Adaptability: Reflect, extract lessons → fourth point fills, diamond glows
6. Start new diamond carrying lessons forward → cycle repeats, each one stronger
Beyond the App
Diamond Theory is not just an app idea. It is an entire ecosystem of educational materials, philosophical writing, visual identity, and economic models that together form a coherent body of work. The app is the most tangible expression, but everything below supports, contextualises, and extends it.
A fully designed semester curriculum titled "The Diamond Perspective: Systems Thinking for Sustainable Societal Transformation." Targets upper-level undergrads and graduate students across social sciences, environmental studies, and sustainability programmes. Includes weekly breakdowns, five learning outcomes, reading lists (Meadows, Senge, Raworth, Capra), assessment rubrics, guest lecture slots, and a group capstone project. A polished prospectus version is also ready for marketing to academic institutions.
A narrative document that personifies money as a character with its own voice and logic. It follows Thomas, a bricklayer, through multiple Diamond cycles — from invisible and unemployed (R0) through skill acquisition (R3,200), to foreman (R7,800), to business owner (R12,000), to scaling (R18,000+). Each cycle reinvests lessons and capital, demonstrating 36% average growth per cycle. The core insight: money does not "run away" — it flows to those who track it, plan with it, invest it, and circulate it through their community.
A Web3 concept designed to engage younger audiences through gamified participation. Users earn DMT by completing Diamond cycles, finishing course modules, volunteering, or mentoring others. The token enables DAO governance (voting on community initiatives), NFT milestone badges, and a marketplace for aligned products and services. An eco-friendly blockchain (Polygon or Solana) is proposed. This is a concept document only — nothing has been built or tokenised.
A detailed analysis mapping the Diamond Perspective's eight-step process cycle onto South African school integration. Aligns with CAPS curriculum requirements, Life Orientation subject outcomes, Ubuntu philosophy, and the Eco-Schools programme. Proposes a phased pilot rollout starting with teacher training and community engagement, through material development, to classroom implementation and assessment. A companion cross-regional analysis compares implementation feasibility across Australia, China, the United States, and Africa, finding South Africa and China most culturally aligned due to collectivist philosophies.
Over 64 AI-generated concept images spanning two tools: 14 from ComfyUI and 50+ from a Midjourney session in December 2024. Visuals range from abstract diamond crystalline structures to "You Are the Diamond" children's illustrations. Three HTML prospectus versions present the theory for different audiences (academic, investor, general). A set of 10 detailed MidJourney prompts defines the visual language: layered interconnected diamonds, celestial energy flows, balance-of-opposites yin-yang integrations, and a "NewEarth" utopian vision.
The most recent strategic direction (March 2026) narrows the focus: use Diamond Theory as the coaching framework for helping people build their own ecommerce businesses. Instead of a general-purpose personal development tool, the idea is to give business coaches a structured methodology and a shared digital workspace for guiding entrepreneurs through the messy reality of starting and growing an online shop.
This is not a small pivot. It transforms Diamond Theory from an abstract framework into a hands-on business tool. The coach and the entrepreneur would both use the app, moving through cycles together. Each cycle could represent a month of trading, a product launch, or a seasonal campaign. The framework gives structure to what is otherwise a chaotic experience of "just try things and see what happens."
| Phase | What the Entrepreneur Does | What the Coach Does |
|---|---|---|
| Awareness | Defines what they sell, who their customer is, what skills and resources they have, and what their honest financial situation looks like. Answers reflective prompts about values and motivation. | Reviews the entrepreneur's self-assessment. Asks probing questions. Surfaces blind spots. Validates or challenges assumptions. |
| Anticipation | Creates a concrete plan: product sourcing, pricing, platform choice, marketing channels, budget allocation, timeline with milestones, and risk identification. | Stress-tests the plan. Checks budget math. Suggests alternatives. Ensures milestones are measurable and realistic. |
| Accountability | Logs actual sales, expenses, customer feedback, marketing results. Tracks what happened versus what was planned. Uploads evidence (screenshots, invoices, analytics). | Reviews tracking data. Identifies trends the entrepreneur might miss. Asks about blockers. Provides encouragement grounded in real numbers, not empty motivation. |
| Adaptability | Reflects on what sold, what did not, what surprised them. Extracts lessons. Decides what to keep, change, or drop for the next cycle. | Facilitates the lesson extraction. Connects patterns across cycles. Helps the entrepreneur see their own growth trajectory over time. |
The Money Story document already proves this works narratively: Thomas the Bricklayer grows from R3,200 to R18,000 per cycle by applying exactly this loop. The ecommerce version replaces bricklaying with online retail, but the mechanics are identical. Track. Plan. Act. Learn. Repeat. Each round compounds.
Direction
- General vs Specific? The app was designed as a general-purpose personal development tool. Are we narrowing focus to ecommerce entrepreneurs, or keeping it broad with ecommerce as one use case?
- Who is the primary user? The entrepreneur being coached? The business coach using it as a tool? Both? This changes the app significantly.
- What gets built first? Diamond A-Spire as specced? A simpler coaching-specific version? The ecommerce platform itself?
Scope
- Diamond Token (DMT) — still in scope? It's a big undertaking on its own. Phase 1 or future?
- 14-week course — how does it fit? Delivered through the app, or separate offering?
- WhatsApp group role? Coordination channel, or part of the delivery mechanism (coaching via chat)?
Technical
- Tech stack review needed. Specs say Next.js 14 + Firebase. Project preference is now SvelteKit. Main plan says Flutter. Which one?
- Backend: Firebase (as specced) vs self-hosted (FastAPI/Postgres which other EVE projects use)?
- AI integration: Claude API confirmed, but prompt specifications need updating for current models.
- Holistic framework that bridges philosophy and practice
- Complete technical specification — ready to build
- Money Story provides concrete, relatable proof
- Natural fit for ecommerce coaching
- Ubuntu/SA alignment creates cultural resonance
- Fractal — works at individual, team, org, community level
- 14-week academic curriculum adds credibility
- 64+ visual assets already generated
- Zero code written — everything is paper
- No empirical validation of the framework's effectiveness
- Direction not confirmed (general vs ecommerce)
- Tech stack conflicts between 3 different spec documents
- No real user testing or feedback
- Crypto token adds complexity without proven demand
- Risk of over-intellectualising — users need transformation, not theory
- 3 referenced docs (Data Story, Skill Story, Image Prompts) don't exist
The App Mapping Matrix explicitly identifies these violations of the framework:
| Anti-Pattern | Why It Kills |
|---|---|
| Skipping Awareness | Reflection never happens. Users jump to planning without understanding values. |
| Task completion focus only | Adaptability dies. Becomes another project management tool. |
| Measuring output, not growth | Loses the moral dimension. Becomes metrics porn. |
| Accountability as punishment | Drives hiding problems instead of learning from them. |
| No visual reward for reflection | Users don't feel progress. Reflection becomes a chore. |
| No loop back | Becomes a one-time intervention instead of a cycle. |
| Theory overload | Intellectualised, not experienced. Users leave before transformation. |
build-specs/ — 7 files
MVP_Minimum_Viable_Requirements.md
Frontend_Architecture_and_Code_Structure.md
Backend_Architecture_and_Firebase_Setup.md
Database_Schema_and_ER_Diagram.md
API_Specification_OpenAPI.md
Wireframes_and_UI_Layouts.md
User_Stories_MVP.md
theory/ — 4 files
Diamond_Theory_Complete_Breakdown.md
Diamond_Theory_App_Mapping_Matrix.md
Money_Story.md
MAIN PLAN.txt
perspective/ — 15 files across 6 subfolders
analysis/ SWOT, Positive Perspective, Negative Perspective
course/ 14-Week Curriculum, Course Description
crypto-token/ Diamond Token (DMT) Strategy
south-african-context/ SA Context, Cross-Regional Analysis
summary/ Overview, High-Level Summary
frontend-dev/ Token Dashboard Design
generated-images/ MidJourney Prompt Library
meta/ — 8 files
COMPLETE_DOCUMENTATION_INDEX.md
COMPLETE_DOCUMENTATION_INVENTORY.md
CRITICAL_DOCUMENTS_CREATED_SUMMARY.md
DELIVERY_COMPLETE.md
BUILD_DOCS_ONLY.md
WHAT_CAN_BE_GENERATED_NEXT.md
CLAUDE-legacy.md
prospectus/ — 5 HTML files
prospectus.html, prospectus-v2.html, prospectus-v3.html
diamond-theory-overview.html, diamond-perspective-index.html
pdfs/ — 6 PDFs + 1 docx
Flagship Article, 6 Diamond Cornerstone, 8-14 Diamond FINAL
Diamond Perspective, diamond 101, Learning Guide BW Knowledge
images/ — 64 images
comfyui/ 14 concept images
midjourney/ 50+ concept images
audio/ — 2 WhatsApp voice notes (Feb 2025)
Consolidated from: C:/_eve_/_eve_projects_/diamond-theory/ (legacy EVE),
Diamond Perspective subfolder, Obsidian archive, communicator outbox.
- Decide direction: General personal development tool, ecommerce coaching tool, or both?
- Decide primary user: Entrepreneur, coach, or dual-persona?
- Decide tech stack: SvelteKit (project preference), Next.js (current specs), or Flutter (main plan)?
- Decide scope: Is DMT crypto token Phase 1 or future? Is the course embedded or separate?
- Decide delivery: App-only, or WhatsApp-integrated coaching?
- Update specs for chosen tech stack (if changing from Next.js)
- Write PRD aligned to chosen direction
- Create job cards via
/eve-define - Build MVP — estimated 4 weeks per original spec
- Beta test with 10 real users
- Complete technical specification (7 build docs)
- Theory documentation (4 files)
- 14-week university curriculum
- Money Story with worked example
- SA educational context analysis
- 64+ visual concept images
- 3 HTML prospectus versions
- User stories with acceptance criteria
- Diamond Token concept (not scoped for build)
- Cross-regional analysis (4 countries)