Forward Impact Team
An engineer, an AI robot, and a business professional stand on a rocky outcrop, scanning the horizon for signals

Landmark

Landmark is the analysis layer for engineering-system signals. It reads Map data to show marker evidence, practice patterns, and snapshot trends for manager-defined teams.

View on GitHub View on npm

Landmark answers one question: what do the signals say about how engineering is functioning — and what should we do about it? It reads Map data, combines objective marker evidence with GetDX snapshot outcomes, and presents analysis grounded in your agent-aligned engineering standard. No LLM calls — fully deterministic.

Audience Model

Audience Views Privacy
Engineer (own data) evidence, readiness, timeline, coverage, voice --email Full individual detail
Manager (1:1 tool) health, readiness, timeline, practiced, voice --manager Individual specificity for direct reports
Director (planning) snapshot, coverage, practiced, initiative, voice --manager Aggregated team views

Commands

Organization

npx fit-landmark org show                    # Full organization directory
npx fit-landmark org team --manager <email>  # Hierarchy under a manager

Snapshots

npx fit-landmark snapshot list
npx fit-landmark snapshot show --snapshot <id> [--manager <email>]
npx fit-landmark snapshot trend --item <item_id> [--manager <email>]
npx fit-landmark snapshot compare --snapshot <id> [--manager <email>]

Evidence & Readiness

npx fit-landmark evidence [--skill <id>] [--email <email>]
npx fit-landmark marker <skill> [--level <level>]
npx fit-landmark readiness --email <email> [--target <level>]
npx fit-landmark timeline --email <email> [--skill <id>]
npx fit-landmark coverage --email <email>
npx fit-landmark practiced --manager <email>

Health

npx fit-landmark health [--manager <email>]

Shows driver scores, contributing skill evidence, engineer voice comments, and (when Summit is installed) inline growth recommendations.

Engineer Voice

npx fit-landmark voice --manager <email>   # Themed team comments
npx fit-landmark voice --email <email>     # Individual comment timeline

Initiatives

npx fit-landmark initiative list [--manager <email>]
npx fit-landmark initiative show --id <id>
npx fit-landmark initiative impact [--manager <email>]

All commands support --format text|json|markdown.

Prerequisites

  • GetDX account with API access configured
  • Map with the activity schema migrated (npx fit-map activity migrate)
  • Standard data with drivers and markers authored in your capability YAML

How It Works

Landmark reads from Map's activity layer:

  1. organization_people for hierarchy and team slicing
  2. github_artifacts + evidence for objective marker analysis
  3. getdx_snapshots + getdx_snapshot_team_scores for quarterly outcomes
  4. getdx_snapshot_comments for engineer voice
  5. getdx_initiatives for initiative tracking
GetDX + GitHub → Map (ingest + store) → Landmark (analyze + present)
                                           ↑
                                       Summit (growth recommendations)

Health works without Summit — it shows driver scores, evidence, and comments. Growth recommendations appear when Summit is installed.

Getting Started

npm install @forwardimpact/landmark
npx fit-landmark marker task_completion

Leadership

Analyze engineering signals — marker evidence, snapshot trends, practice patterns, team health, and engineer voice.

Engineers

Check your evidence record, promotion readiness, growth timeline, and skill coverage against your agent-aligned engineering standard markers.

See Landmark Internals for architecture details.