Philosophy
This document explains the thinking behind AfaFlow. It clarifies why certain decisions are made, how trade-offs are evaluated, and what mental models guide the product.
1. Trust over time, not short-term productivity
Most task systems optimize for speed, features, or a feeling of immediate control. AfaFlow optimizes for long-term trust.
A task system is only valuable if it continues to reflect reality after weeks, months, and years of use. When systems decay, users stop trusting them—and eventually abandon them.
Productivity failure is often a system design failure, not a personal discipline problem.
2. Tasks are promises, not ideas
In AfaFlow, a task represents an intentional commitment, not a vague aspiration.
This is why tasks are encouraged to:
- belong to a meaningful context (Goals)
- have a clear start point
- remain reviewable over time
Ideas belong in notes. Tasks belong in systems designed for action and review.
Blurring this distinction creates guilt, not progress.
3. Review matters more than execution
Execution feels productive. Review keeps the system honest.
Without regular review:
- priorities drift
- tasks lose relevance
- urgency becomes artificial
- guilt accumulates silently
AfaFlow treats review as the stabilizing force of the system. Execution happens within that structure, not instead of it.
Review is designed to be:
- lightweight
- reflective
- unavoidable, but not burdensome
4. Energy matters more than time
Time-based planning assumes consistent focus and motivation. Real life does not work this way.
Energy fluctuates. Cognitive capacity changes. Some work requires clarity, not urgency.
AfaFlow helps users align work with realistic energy states instead of enforcing rigid schedules.
Energy guidance supports decisions. It does not prescribe behavior.
5. Friction can be intentional
Not all friction is bad.
Some friction exists to:
- force reflection
- prevent over-commitment
- protect clarity
AfaFlow avoids automation that replaces human judgment. The goal is not to eliminate thinking, but to reduce unnecessary thinking.
6. Local-first is about ownership, not ideology
Local-first design is not a technical preference. It is an ethical one.
Users should:
- own their data
- know where it lives
- access it without permission
- leave without penalty
Cloud services, AI, and integrations are valuable only when they respect this ownership model.
Convenience must never override control.
7. AI assists, it does not command
AI works best as:
- a mirror
- a suggestion engine
- a reflection aid
It should not:
- enforce priorities
- override intent
- automate decisions that carry personal cost
AfaFlow treats AI as optional support, never as an authority.
8. Calm is a design outcome
Stress is not a productivity feature.
AfaFlow aims to:
- surface reality early
- reduce background anxiety
- remove artificial urgency
- normalize unfinished work
A calm system allows users to think clearly, decide intentionally, and adjust without shame.
This is not softness. It is sustainability.
9. Philosophy evolves, Foundation decides
This philosophy may evolve as understanding deepens and context changes.
When philosophy and practice conflict,
FOUNDATION.md takes precedence.
Philosophy explains. Foundation decides.