Technical Management (TECHNICAL)
Manage the technical health and assets of your engineering organization through "Decisions" and "Metrics."
Architecture Decision Records (ADR)
Keep an immutable record of technical choices and architectural changes.
- Workflow:
- Proposed: Propose a new technical choice.
- Accepted: Approved and adopted after review.
- Superseded/Deprecated: Overwrite old decisions.
- Star Feature: Mark critical components (e.g., choice of Database) as "Starred" to highlight core technical stack information.
- Team & Service Liaison: Categorize records by linking them to specific teams or microservices.
Engineering Metrics (Four Keys)
Automatically collect and visualize the four metrics defined by DORA (DevOps Research and Assessment).
- Deployment Frequency: Count production releases via GitHub integration.
- Lead Time for Changes: Average time from commit to production.
- Change Failure Rate: The failure rate of production changes.
- Time to Restore Service: Time from incident detection to resolution.
TIP
These metrics are updated automatically via GitHub Actions workflow completions or Jira ticket status changes.
System Topology
Use XYFlow (React Flow) to draw physical and logical dependencies between services.
- Service Catalog: Centrally manage technical stacks (Language, DB, Libraries, etc.).
- Dependency Visualization: Understand API callers and callees in a graph format to identify the impact of changes.