tomtan/EverOS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
518b8eca855fcd9310afa7c254edf6c6a8f2a938
EverOS/.claude/rules/code-style.md
Elliot Chen 518b8eca85 chore: initialize EverOS 1.0.0 
md-first memory extraction framework for AI agents.

Markdown is the single source of truth; SQLite holds state and LanceDB
provides the rebuildable vector + BM25 + scalar index. The codebase follows
a single-direction DDD layering (entrypoints -> service -> memory -> infra,
with component / core / config cross-cutting) enforced by import-linter.

Engineering surface:
- Coding conventions in .claude/rules/ (path-scoped) and workflows in
  .claude/skills/ (/commit, /new-branch, /pr).
- GitHub Actions CI runs make lint + test + integration; pre-commit mirrors
  the gates locally (ruff, hygiene hooks, gitlint commit-msg).
- Commit messages follow Conventional Commits, enforced by gitlint.
- make lint also enforces datetime two-zone discipline and OpenAPI drift.
2026-06-06 07:33:17 +08:00

1.1 KiB
Raw Blame History

Code style rule (always loaded)

  • Formatter & linter: ruff is the single tool (replaces black / isort / flake8). Line length 88, target py312. Run make format to auto-fix; make lint checks.
  • Active ruff rule sets: E F I N UP B SIM ASYNC. Don't disable a rule inline unless there's a genuine reason — prefer fixing the code.
  • Type hints: annotate every public function signature (params + return). The codebase is ~100% typed; keep it that way.
  • from __future__ import annotations at the top of every module — annotations are strings, so forward refs and X | None unions are free.
  • Prefer collections.abc (Sequence, Mapping) over concrete list/dict in signatures; use Protocol for structural interfaces.
  • No dead code: no commented-out blocks, no unused imports, no speculative abstractions. Delete rather than comment out.
  • Naming: *Manager (orchestrators), *Provider (injectable services), *Reader/*Writer (persistence), *Recaller (search routes). Follow the established suffix when adding a sibling.