hforge-analyze

Analyze repository health and risks using Harness Forge runtime artifacts.

3|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/ldilov/harness-forge --skill hforge-analyze
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hforge-analyze
Source: https://github.com/ldilov/harness-forge/tree/main/.agents/skills/hforge-analyze
Command: npx skills add https://github.com/ldilov/harness-forge --skill hforge-analyze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps engineering teams understand repository health by analyzing Harness Forge runtime surfaces, refreshing stale findings, summarizing repository shape and risks, and promoting architecture-significant insights into durable notes or ADRs.

Core Features & Use Cases

  • Runtime-driven health analysis using Harness Forge surfaces to produce a comprehensive repo health report.
  • Refresh stale findings and summarize repo shape and risks.
  • Promote architecture-significant findings into durable notes or ADRs under .hforge/runtime/decisions/.
  • Provide actionable next steps and recommended actions.

Quick Start

Run hforge analyze to examine the repository and generate the initial health report

Frequently Asked Questions about hforge-analyze

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze repository health and surface architecture risks?

To analyze repository health and surface architecture risks, run hforge analyze to examine Harness Forge runtime surfaces, refresh stale findings, and generate a comprehensive report summarizing repo shape and actionable risks.

How do I promote architecture findings into ADRs?

Promote architecture findings into ADRs by using Harness Forge review workflows to elevate significant insights, saving them as durable notes or Architecture Decision Records under the .hforge/runtime/decisions/ directory.

Do I need Harness Forge initialized to analyze my repository?

Yes, repository analysis requires an existing Harness Forge initialization. The skill needs access to .hforge runtime artifacts and must execute hforge status, refresh, and review commands to generate the health report.

What is the best way to refresh stale repository findings?

The best way to refresh stale repository findings is to execute the hforge refresh command, which updates the runtime surfaces and ensures your comprehensive health report reflects the current state of the codebase.

How does Harness Forge runtime-driven health analysis work?

Harness Forge runtime-driven health analysis works by reading .hforge runtime artifacts, executing status and review commands, and summarizing the repository's structural shape, risks, and health into a comprehensive report with recommended next steps.