Real Organic Flow Examples

See how Organic Flow works in practice. These are actual experiments from this repository, showing the complete cycle from input to knowledge.

Example: Parallel Test Execution

1. Input: Problem Identified

inputs/problems/slow-test-suite.md

# Slow Test Suite

Our test suite takes 15 minutes to run, making the feedback loop painfully slow.

Developers avoid running tests locally, leading to more CI failures.

2. Assumption: Hypothesis Formed

assumptions/parallel-test-execution.md

If we run tests in parallel using pytest-xdist,

then we can reduce test suite runtime by 60-70%,

given our tests are mostly CPU-bound and independent.

3. Experiment: Test in Branch

Branch: experiment/parallel-tests

  • Installed pytest-xdist
  • Configured parallel execution
  • Fixed thread-safety issues
  • Measured performance improvements

4. Knowledge: Learnings Harvested

learnings/parallel-test-execution-results.md

✅ What Worked:

  • Achieved 65% speedup (15min → 5.5min)
  • CPU-bound tests parallelized perfectly

❌ What Didn't:

  • 12 database tests failed due to isolation issues
  • Some fixtures weren't thread-safe

💡 Key Insight: Run database tests separately, not in parallel

Knowledge PR Example

PR #42: Harvest learnings from parallel test experiment

🌱 Knowledge PR +45 lines No code changes

Files changed:

  • learnings/parallel-test-execution-results.md
  • patterns/parallel-test-strategy.md
  • experiments.yaml (status update)

PR Description:

This PR harvests learnings from the parallel test execution experiment. The experiment achieved its primary goal (65% speedup) but uncovered important constraints around database test isolation. These learnings will guide future performance optimization efforts.

Ready to Try Organic Flow?

Start with a real problem you're facing. Document it, form an assumption, and run your first experiment.

Start Your First Experiment