Skip to content

Eys-55/ace-workflows / projects/real-life-workflows/quarantine/imports/2026-07-07-market-research-agent/skills/tracker-astro-monitor

tracker-astro-monitor

Verified

Build and maintain the read-only Astro dashboard that monitors this control repo's tracker state, workflow runs, workstreams, upload status, stale surfaces, and next actions from local ops JSON only.

FileKindSize
SKILL.mdskill md2.8 KB
---
name: tracker-astro-monitor
description: Build and maintain the read-only Astro dashboard that monitors this control repo's tracker state, workflow runs, workstreams, upload status, stale surfaces, and next actions from local ops JSON only.
---

# Tracker Astro Monitor

Use this workflow when the user wants a local UI for watching what is happening
inside the control repo tracker.

## Repeated Job

Turn the file-backed tracker state under `ops/` into a read-only Astro
dashboard that an operator can open locally to see current projects,
workstreams, workflow runs, upload status, stale/non-project surfaces, and next
actions.

## Trigger

Use this workflow when the user asks to:

- build or update the tracker monitor UI;
- inspect tracker state visually;
- add a 2D dashboard panel for workflow runs, projects, sessions, upload state,
  or stale surfaces;
- make the control repo easier to monitor without changing tracker authority.

Refuse or reroute when the request wants third-party writes, publishing,
credential changes, live remote mutation, replacing the tracker registry, or a
non-Astro app stack.

## Input Contract

The workflow reads only local tracker surfaces:

- `ops/registry/projects.json`;
- `ops/registry/workstreams.json`;
- `ops/registry/workflow-runs.json`;
- `ops/sync/github-upload-state.json`;
- optional event, session, handoff, and daily-rollup files when future panels
  need them.

The UI must not infer active projects from folder names, stale README tables, or
old lane docs. Tracker registry state remains authoritative.

## Output Artifact

The current output is a static Astro dashboard:

- export adapter: `node scripts/control-repo.mjs export-tracker-ui-data`;
- dashboard snapshot: `tracker-ui/src/data/tracker-dashboard.json`;
- Astro route: `tracker-ui/src/pages/index.astro`;
- styles: `tracker-ui/src/styles/global.css`;
- validation: `tests/control-repo.test.mjs`.

## Agent Lanes

- tracker-data lane: read and normalize local tracker JSON.
- UI lane: render a dense, work-focused, 2D Astro dashboard.
- validation lane: prove the exporter and route consume the expected snapshot.
- review lane: check that no UI panel claims authority beyond tracker data.

## Validation Loop

Before treating monitor changes as complete, run:

```bash
npm test
npm run build
npm run validate
git diff --check
```

## Safety Contract

This workflow is read-only. It must not:

- write to third-party systems;
- publish, push, merge, or post without explicit approval;
- mutate tracker registries from the browser;
- use credentials or auth bypasses;
- present folder scans as project authority;
- use 3D, WebGL, canvas scenes, or decorative app surfaces for the monitor.

The dashboard may show stale or non-project surfaces, but it must label them as
tracker context rather than active project truth.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall