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:
1. Proposed: Propose a new technical choice.
2. Accepted: Approved and adopted after review.
3. 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.

Automatically collect and visualize the four metrics defined by DORA (DevOps Research and Assessment).

TIP

These metrics are updated automatically via GitHub Actions workflow completions or Jira ticket status changes.

Quantitatively define and monitor system reliability.

SLI (Service Level Indicator): The metric to be measured (e.g., % of API latency < 300ms).
SLO (Service Level Objective): The target value for SLI (e.g., 99.9%).
Error Budget: The margin over the target value. Use this as a criterion for deciding whether to invest in "Innovation (feature development)" or "Reliability improvement."

Manage factual reviews and prevention plans when major incidents or SLO breaches occur.

Root Cause Analysis (RCA): Use 5 Whys to identify structural issues rather than surface symptoms.
Timeline Logging: Accurately record the sequence of events from occurrence to detection, response, and recovery.
Action Item Sync: Directly register decided prevention tasks as "Technical Debt" and track them until completion.
Blameless Culture: Focus on improving system vulnerabilities rather than assigning individual blame.

Strategically manage new technology selection and prototype development.

Theme Management: Propose technology stacks or concepts to be verified as "Themes."
Assetize Findings: Register verification reports and sample code as "Artifacts" to accumulate organizational shared knowledge.
Skill Alignment: R&D results can be automatically reflected in "Team Skills" and "Individual Proficiency."

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.

Visualize mid-to-long term technical investment plans and manage the balance between feature development and infrastructure improvement.

Strategic Themes: Define high-level goals like "Legacy Modernization" or "Security Hardening."
Gantt Chart (Timeline) View: Overview implementation periods and progress on a timeline.
- Intuitive Schedule Adjustment: Adjust schedule dates by dragging the center of a milestone bar, or resize from the left/right handles to extend or shrink the duration. Changes are saved to the server in real-time.
- Today Indicator & Auto Scroll: A vertical line (Today Indicator) marks the current date, and the timeline automatically scrolls horizontally to center today's date upon load.
Detailed Metadata Visualization: Milestone bars show inline badges for associated project progress (%), resolved/total technical debts, and linked ADR counts. Hovering over a bar reveals a tooltip containing detailed schedule and metadata info.
Mobile Fallback List View: On mobile devices, the Gantt timeline automatically collapses into a clean accordion list of strategic themes. Under each theme, users can view milestones as vertical cards displaying status badges and metadata.
Investment Ratio Dashboard: Automatically calculate the percentage of effort allocated to technical strategy compared to total planned effort. Useful for alignment with management.
Asset Linking: Directly link "Technical Debts" and "ADRs" to roadmap milestones to track resolution progress.