# googlechrome/modern-web-guidance-src

> modern-web-guidance-src is the source repository for Modern Web Guidance, a set of skills that embed web platform expertise, best practices, and browser compatibility data into coding agents. It holds the code and documentation used to author, calibrate, and evaluate that content. The core idea is that the skills steer agents away from legacy patterns and toward modern web platform APIs, delivered through a CLI that returns targeted guidelines into the agent's context. The main language is TypeScript.

Source: https://github.com/googlechrome/modern-web-guidance-src
Indexed: commit ebb6f3a on 2026-11-14 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Command-line tool
- Language: TypeScript
- Stars: 5,505 at index time
- License: Apache-2.0
- Code health: 6.5/10, Fair
- Last commit: 2026-11-13
- Contributors: 42

## Install

From the README: https://github.com/googlechrome/modern-web-guidance-src#quickstart

Run the interactive wizard to install Modern Web Guidance.
    npx modern-web-guidance@latest install

Search for guides relevant to a task without installing.
    npx modern-web-guidance@latest search "animate a dialog modal backdrop"

Retrieve a guide by its ID.
    npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"

Scan a codebase for legacy patterns to modernize.
    npx modern-web-guidance@latest legacy-scan .

## How it works

Commands enter through the command line, with entry points such as bin/gd.ts and src/analyzing/cli.ts among the five entry points indexed for the repository. The src directory holds most of the code, 425 files covering analysis, the dashboard, CI, and telemetry. The guides directory, with 226 files, holds the guide content that the CLI searches and retrieves by ID. Each skill is defined in a SKILL.md file under .agents/skills, such as .agents/skills/coherence-auditor/SKILL.md, with helper scripts such as coherence-audit.ts beside it. The grader replay script at .agents/skills/grader-replay/scripts/replay.ts is one of the central files in the repository. src/dashboard/server.js is an entry point for the dashboard.

- bin/gd.ts: entry point
- src/analyzing/cli.ts: entry point
- src/ci/gh-demo-proxy/index.js: entry point
- src/cli/telemetry/watchdog/main.ts: entry point
- src/dashboard/server.js: entry point
Modules: src, guides, .agents, bin. 1,864 files, 163,562 lines, 4,874 symbols.

## Code health

- Score: 6.5/10 (Fair)
- Rank: #157 of 4,000+ indexed repos
- Hotspots: src/dashboard/landing.js, src/dashboard/dashboard.js, src/analyzing/scanners/scanners.test.ts, src/ci/sync-pipeline-issue.ts, guides/ui-components/menu/targets/daily-grind/grader.ts
- Lowest file: src/dashboard/dashboard.js
- Dead code: 5 findings

## Maintenance

- Last commit 2026-11-13, 500 commits
- 42 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/googlechrome/modern-web-guidance-src/security

## More

- Page: https://repowise.dev/repo/googlechrome/modern-web-guidance-src
- Ask this codebase: https://repowise.dev/repo/googlechrome/modern-web-guidance-src/chat
- Docs: https://repowise.dev/repo/googlechrome/modern-web-guidance-src/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/googlechrome/modern-web-guidance-src