These are not startups.
They are problems worth solving with clean engineering and clear exits.
I do not intend to: - Run a company - Be a CEO - Build a lifestyle brand - Grind indefinitely
I do intend to: - Identify real problems - Design elegant solutions - Protect IP - De-risk ideas early - Hand off execution to the right operator - Exit cleanly
This system exists to keep me focused, honest, and efficient.
If you just want to read and apply the framework:
PROCESS.mdIDEA_INTAKE.mdNEW_IDEA.mdideas/example-idea/If you want a local, reproducible setup:
ideas/_template/make pdf,
make epub, make htmlPROCESS.md - The full idea
lifecycle, phases, and kill criteriaIDEA_INTAKE.md - 15-minute
gate to filter ideas earlyNEW_IDEA.md - Quickstart for
creating a new idea folder01_ENERGY_BUDGET.md -
Weekly constraints and burnout guardrails00_PIPELINE.md -
Single-glance state of all ideasideas/_template/ -
Canonical templates for idea files and artifactsEvery TREP idea must satisfy all of the following:
If an idea violates one of these, it is parked or killed.
TREP/
├─ 00_PIPELINE.md
├─ 01_ENERGY_BUDGET.md
├─ CHANGELOG.md
├─ CODE_OF_CONDUCT.md
├─ CONTRIBUTING.md
├─ GOVERNANCE.md
├─ IDEA_INTAKE.md
├─ LICENSE
├─ NEW_IDEA.md
├─ PROCESS.md
├─ README.md
├─ WEEKLY_REVIEW.md
├─ ideas/
│ ├─ _template/
│ │ ├─ README.md
│ │ ├─ NOTES.md
│ │ ├─ PROBLEM.md
│ │ ├─ SOLUTION.md
│ │ ├─ MARKET.md
│ │ ├─ RISKS.md
│ │ ├─ IP.md
│ │ └─ artifacts/
│ │ ├─ ELEVATOR.template.md
│ │ ├─ IDEA_README.template.md
│ │ ├─ ONE_PAGER.template.md
│ │ ├─ PITCH_DECK.template.md
│ │ └─ RULES.md
│ └─ idea-<short-name>/
│ ├─ README.md
│ ├─ NOTES.md
│ ├─ PROBLEM.md
│ ├─ SOLUTION.md
│ ├─ MARKET.md
│ ├─ RISKS.md
│ ├─ IP.md
│ └─ artifacts/
│ ├─ elevator.md
│ ├─ one-pager.md
│ └─ pitch-deck.md
Rules: - No idea lives directly in /TREP - Every idea
gets its own folder - Artifacts are generated, not
improvised
ideas/idea-<short-name>/ideas/_template/ into itREADME.md (state + summary)IDEA_INTAKE.mdNOTES.md only if it passesThis framework assumes I am not the long-term operator. Every idea must have a plausible acquirer, a clear revenue path, and a defendable wedge (IP or speed). If that is not true, the idea is parked or killed early.
The files in ideas/_template/ are the only allowed
starting point. Artifacts in an idea folder must be generated from those
templates, not invented from scratch.
Ideas move through states, not vibes.
State is recorded in the idea’s README.md.
Every idea has a README.md.
If it’s not here, it doesn’t exist.
# <Idea Name>
**State:** SHAPING
**Owner:** Ryan
**Last Updated:** YYYY-MM-DD
## One-Sentence Summary
<Plain English. No jargon. If this is hard, stop.>
## Why This Exists
- What problem is real?
- Who feels it acutely?
- Why it hasn’t been solved cleanly yet
## What I’m Optimizing For
- Fast validation
- IP clarity
- Obvious acquirer interest
- Minimal personal operational burden
## What I’m Explicitly Not Doing
- Running ops
- Fundraising marathons
- Consumer brand building
## Current Questions
- ?
- ?
---
## 8. Open Source Notes
- See `LICENSE` for usage terms
- See `CONTRIBUTING.md` for how to propose improvements
- See `CODE_OF_CONDUCT.md` for community standards
- `ideas/example-idea/` is fictional and for reference only
---
## 9. Docs and Releases
- Docs landing page: `docs/index.md`
- Release checklist: `RELEASE.md`
- Local builds: `make pdf`, `make epub`, `make html`
# TREP Process
## Getting Ideas Out of My Head and Onto Paper (Without Lying to Myself)
> This process exists to **externalize thinking**, not to force progress.
>
> Speed is not the goal.
> Clarity is.
---
## Guiding Principles
- Ideas decay when left in my head
- Writing reveals weak thinking quickly
- Early structure prevents late rework
- Killing ideas early is a success, not a failure
- This process protects **time, energy, and integrity**
---
## Phase 0 — Mental Quarantine
**Goal:**
Create distance between the idea and my identity.
**Rule:**
An idea is not “mine” until it survives writing.
**Actions:**
- Create a folder:
`ideas/idea-<short-name>/`
- Copy templates from:
`ideas/_template/`
- Do **not** pitch it to anyone yet
- Do **not** name it cleverly
- Do **not** research competitors yet
**Output:**
Empty folder + blank files
---
## Phase 1 — Brain Dump (Unfiltered)
**Goal:**
Get the idea out of my head *without organizing it*.
**File:**
`NOTES.md`
**Prompt:**
- What keeps bothering me about this?
- Where have I seen this problem in the wild?
- Who complains about this (explicitly or implicitly)?
- What would a “dumb but effective” solution look like?
- Why does this feel solvable by *me*?
**Rules:**
- Bullet points only
- No editing
- No structure
- No judgment
**Timebox:**
20–30 minutes max
**Stop when:**
My head feels quieter.
---
## Phase 2 — Problem Crystallization
**Goal:**
Decide whether the *problem* is real before designing anything.
**File:**
`PROBLEM.md`
**Questions to answer (plain English):**
- Who has this problem?
- How often does it occur?
- What happens if it’s not solved?
- Who pays the cost?
- How is this handled today?
**Hard Check:**
If I cannot explain the problem in **5 sentences**, stop.
**Outcome:**
- Clear problem → continue
- Vague, aesthetic, or hypothetical → park or kill
---
## Phase 3 — Solution Sketch (Resist Over-Engineering)
**Goal:**
Describe the solution without building it.
**File:**
`SOLUTION.md`
**Questions:**
- What does the solution *do*?
- What does it explicitly *not* do?
- What is the key technical insight?
- What makes this difficult for others?
**Rules:**
- No diagrams yet
- No implementation details
- No tech stack decisions
**Hard Check:**
If the solution sounds like:
- a platform
- an ecosystem
- an AI-powered anything
Rewrite it.
---
## Phase 4 — Reality Screen
**Goal:**
Stress the idea against reality *before* falling in love with it.
**Files:**
- `MARKET.md`
- `RISKS.md`
### MARKET.md
Answer honestly:
- Who buys this?
- Who uses it?
- Why would they buy it *now*?
- How many such buyers plausibly exist?
- How do they currently justify spend?
### RISKS.md
List only real risks:
- Adoption friction
- Regulatory exposure
- Technical uncertainty
- IP weakness
- Substitution risk
**Rule:**
If risks feel uncomfortable, good — keep going.
---
## Phase 5 — IP First Pass
**Goal:**
Decide if this is an **IP play** or a **speed play**.
**File:**
`IP.md`
**Questions:**
- What might be patentable?
- What is clearly not?
- What existing products or companies feel adjacent?
- Is this worth a provisional patent discussion?
**Hard Check:**
If there is no defensibility story, the exit must be obvious.
---
## Phase 6 — Compression
**Goal:**
Reduce everything to investor-readable artifacts.
**Files (in order):**
1. `artifacts/elevator.md` (from `ELEVATOR.template.md`)
2. `artifacts/one-pager.md` (from `ONE_PAGER.template.md`)
3. `artifacts/pitch-deck.md` (from `PITCH_DECK.template.md`)
**Rule:**
- Each artifact must feel *simpler* than the last
- If clarity decreases, stop and go back
---
## Phase 7 — State Decision
**Goal:**
Decide what happens next — deliberately.
**File:**
`README.md`
Set:
```markdown
**State:** SEED | SHAPING | SCREENING | INVESTOR-READY | PARKED | KILLEDQuestions: • Is this worth more of my time? • Does this align with my constraints? • Is the next step clear and small?
If no: Park or kill it. Document why.
⸻
Kill Criteria (Use Early, Use Often)
Kill the idea if: • The problem is aesthetic, not operational • The buyer is vague or hypothetical • IP is weak and speed advantage is unclear • It requires me to operate a company • It only works if everything goes right
Killing early is a win.
⸻
Final Reminder
The goal is not to “advance ideas.”
The goal is to discover which ideas deserve existence outside my head.
This process exists to help me tell the difference.
This checklist exists to prevent me from confusing interest with merit.
If an idea can’t pass this in 15 minutes, it does not deserve further attention — yet.
<idea-short-name>Rule:
No clever branding. No metaphors.
Fill this in without editing:
“This idea addresses
experienced by ,
by, resulting in .”
If this feels vague or fluffy, stop.
Answer yes / no only.
If any are “no” → park the idea.
Answer honestly:
Only calm energy is allowed.
Choose one:
If parked or killed, write one sentence explaining why.
If this takes longer than 15 minutes, I am already violating the process.
Use this when an idea passes the 15-minute gate.
ideas/idea-<short-name>/
Copy everything from:
ideas/_template/
Update:
README.md (state + one-sentence summary + next
step)If the README is not clear, stop and fix it before doing anything else.
Follow the process in PROCESS.md.
If any phase fails, park or kill the idea and document why.
I treat TREP like a finite resource, not a hustle.
If any appear → pause.
This review exists to prevent slow drift, sunk-cost fallacy, and idea hoarding.
No skipping. No expanding. No guilt.
Open: - 00_PIPELINE.md
Scan: - SHAPING - SCREENING - INVESTOR-READY
Ask: - Do these still deserve attention?
For each idea not parked or killed, answer:
If nothing changed → flag it.
Answer honestly:
If yes to any → reduce scope immediately.
For each idea, choose one: - ⬜ Advance - ⬜ Pause - ⬜ Park - ⬜ Kill
Update: - Idea README.md -
00_PIPELINE.md
Document why.
Write one sentence:
“Next week, the only TREP work I intend to do is:
<specific, bounded action>”
Nothing else is allowed.
TREP is not a second job.
It is a disciplined filter for good ideas, not a place to accumulate them.
End review. Close vault. Move on.
Thanks for helping improve TREP.
This project uses Semantic Versioning with tags like
vMAJOR.MINOR.PATCH.
Please use Conventional Commits for changes:
feat: ... for new capabilitiesfix: ... for bug fixes or correctionsdocs: ... for documentation changesTREP is opinionated and maintained by a single owner.
We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
Examples of behavior that contributes to a positive environment for our community include:
Examples of unacceptable behavior include:
Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official email address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at:
INSERT_CONTACT_METHOD
All complaints will be reviewed and investigated promptly and fairly.
Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
Community Impact: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
Consequence: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
Community Impact: A violation through a single incident or series of actions.
Consequence: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
Community Impact: A serious violation of community standards, including sustained inappropriate behavior.
Consequence: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
Community Impact: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
Consequence: A permanent ban from any sort of public interaction within the community.
This Code of Conduct is adapted from the Contributor Covenant, version 2.1, available at https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
Community Impact Guidelines were inspired by Mozilla’s code of conduct enforcement ladder.