HN Showcase
Back to browse
GitHub Repository

Shift from passive documentation to active enforcement.

58 starsTypeScript

Tool to surface past architectural decisions directly on Pull Requests

by iamalizaidi·Mar 1, 2026·5 points·0 comments
Visit ProjectView on HN

AI Analysis

●●SolidSolve My Problem

Surfaces decisions on PRs, but tooling assumes decisions are documented—doesn't solve the core problem.

Strengths
  • •Real pain point: senior engineers leave, decisions get re-litigated. Prevents duplicate work on settled questions.
  • •GitHub Action integration is frictionless; CLI option covers other CI/CD systems.
  • •Privacy-first: only aggregates metrics, no code contents sent externally; opt-out telemetry.
Weaknesses
  • •Requires teams to pre-document decisions in `.decispher/decisions.md`—adoption burden falls on already-busy teams.
  • •Doesn't help teams without documentation culture; tool only amplifies what's already written.
Target Audience

Engineering teams managing large codebases with institutional knowledge loss

Similar To

ADR (Architecture Decision Records) tooling · Confluence decision templates

Similar Projects