Files
tasknote/ai/context/architecture_principles.md
T
rmcamposandGitHub 5fec30fea0 feat: add SDD and DDD filer for AI based development and Spec 001 implementation (#60)
* feat: add initial files and spec 1

* feat: add spec for rich text feature

* chore: restore file from broken AI session

* feat: add project constraints to ai

* chore: update spec feature prompt

* feat: add multiple tags support - wip

* test: fix test cases

* chore: move tag list to below the inputs

* chore: add ngrok files and updates

* fix: session issues and query using HQL

* test: fix test cases
2026-05-26 11:58:04 -03:00

869 B

Architecture Principles

Core Principles

  • Keep solutions simple and focused on the problem at hand.
  • Prefer readability and maintainability over cleverness.
  • Small functions and modules that do one thing well.
  • Use clear and descriptive names for variables, functions, and classes.
  • Avoid premature optimization; optimize only when necessary.
  • Avoid over-engineering; build only what is needed for the current problem.
  • Clear boundaries between components to promote separation of concerns.
  • Prefer to maintainability over perfection

Delivery Principles

Prefer:

  • small specs
  • iterative delivery
  • vertical slices of functionality
  • simple APIs
  • clear documentation
  • understandable code

Avoid:

  • giant upfront architecture
  • premature optimization
  • speculative abstractions
  • over-engineering
  • unnecessary complexity
  • unnecessary microservices