ao-cyber-systems/awareness
plugins/devflow/skills/awareness/SKILL.md
Show cross-repo awareness: who else is working on what (peer view) and how the work fits into org-wide progress (Product Roadmap view). Renders both views by default. Use when the user wants to know if anyone else is working on related stuff, where their work fits in the org's larger progress, or simply "what's in flight". Triggers on: "who else is working on this", "what's in flight", "anyone else on this", "show org progress", "show parallel sessions", "what's everyone doing", "what teammates are working on", "is this work overlapping with anyone", "is anyone else on this".
tools
Updated May 6, 2026
$ install --global
skillsauthnpx skillsauth add ao-cyber-systems/devflow-claude awarenessInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 6, 2026, 3:03 AM109.0s1 file scanned
SKILL.md
- name:
- awareness
- description:
- |
- Show cross-repo awareness:
- who else is working on what (peer view) and how the work fits into org-wide progress (Product Roadmap view). Renders both views by default.
- Triggers on:
- who else is working on this", "what's in flight", "anyone else on this", "show org progress", "show parallel sessions", "what's everyone doing", "what teammates are working on", "is this work overlapping with anyone", "is anyone else on this".
- argument-hint:
- [--peer-only|--org-only] [--quarter Q] [--product P] [--refresh [peer|org]] [--no-fetch] [--raw]
<objective>
Render two awareness views side-by-side:
- Peer (this repo, git-branch-based) — branches in
origin/*with active.planning/STATE.mdshowing teammate's current objective + TRD + last commit. - Org (Product Roadmap project) — items grouped by Product × Quarter, with each item's direct sub-issues (or task-list bullets when no native sub-issues exist).
Both views are pull-only (no daemon). Cache lives at .planning/.awareness-cache.json with 10-minute TTL per section. The cache file is gitignored.
Limitations (locked):
- Stale = invisible (peer side): branches not pushed in 30 days don't show. Push for visibility.
- Local-repo scope (peer side): only branches in THIS repo's origin show — teammates working in other repos appear via the org view, not the peer view.
- No handoff state: the
df:handoffwatcher (already shipped) handles "blocked on user" — awareness here is purely informational. </objective>
<execution_context> @.planning/STATE.md @.planning/.awareness-cache.json </execution_context>
<process> **Run the awareness CLI with arg passthrough:**node ~/.claude/devflow/bin/df-tools.cjs awareness show $ARGUMENTS
The CLI:
- Reads
.planning/.awareness-cache.json(creates if missing). - For each section requested (peer, org, or both):
- If TTL-expired OR
--refreshflag, re-runs scanner and writes cache. - Otherwise, serves from cache.
- If TTL-expired OR
- Renders markdown to stdout (or raw JSON with
--raw).
If org-side gh auth fails:
- With
--org-only: structured JSON error to stderr + exit 1. - Default mode (both sections): renders peer-only with a warning about org failure.
After the command runs, present the output to the user. Don't summarize — show the markdown verbatim so the user can scan branches + projects. </process>
<context> The cache file `.planning/.awareness-cache.json` is gitignored (TRD 02-04). It's safe to commit accidentally — the gitignore prevents it.Subcommand options:
df-tools awareness scan-peer [--no-fetch]— Walk origin/*, emit JSON. Used directly by tests + the SessionStart cache populator hook.df-tools awareness scan-org— Walk org Product Roadmap, emit JSON. Requiresghauth scopes: project, read:project, repo.df-tools awareness show— Combined view (this skill's default).
Filter flags:
--peer-only/--org-only— Show one section only.--quarter Q2-2026— Filter org section by quarter (substring match, case-insensitive).--product DevFlow— Filter org section by product (exact match, case-insensitive).--refresh— Force re-fetch of both sections (bypass TTL).--refresh peer/--refresh org— Force re-fetch of just one section.--no-fetch— Skipgit fetch --all --prunefor the peer scanner (offline mode).--raw— Emit raw JSON to stdout instead of formatted markdown.
This skill is the read-side aggregation layer for cross-repo awareness. It doesn't write anything beyond the cache file. The data lives where it always lived: git refs (peer side) + the org Product Roadmap project (org side). </context>
Related Skills
ao-cyber-systems/flow
development
VerifiedTrustedCommunity
Orchestrate a multi-step DevFlow workflow by chaining skills. Use when the user wants to invoke a sequence of skills as one ask (e.g., "build and sync to github", "research, plan, then build", "ship and announce"). Triggers on: "ship X to Y", "build and X", "plan and X", "X then Y", "in one go", "as a chain", "all in sequence", "chain", "ship-and-sync", "research-plan-build"
SKILL.mdUpdated May 26, 2026
ao-cyber-systems/new-monorepo
testing
VerifiedTrustedCommunity
Stamp a new polyglot monorepo using the AO Cyber Systems scaffold — root CLAUDE.md with Layout table, per-area CLAUDE.md, path-filtered CI workflows, comprehensive .gitignore, and the no-binaries pre-commit hook config. Use this for new product monorepos (the 5-monorepo architecture: aodex, aosentry, eden-biz, politihub, aohealth, plus future ones). Triggers on: "new monorepo", "scaffold a monorepo", "set up a monorepo", "create a new product monorepo".
SKILL.mdUpdated May 12, 2026
ao-cyber-systems/monorepo-doctor
development
VerifiedTrustedCommunity
Validate that a monorepo follows the AO Cyber Systems layout convention — root CLAUDE.md declares every area, every area has its own CLAUDE.md, no compiled binaries are tracked in git. Reads the root `CLAUDE.md` Layout table, walks the working tree, and reports drift in a single Markdown summary. Standalone — works on any repo. Triggers on: "audit monorepo layout", "monorepo doctor", "is this monorepo healthy?", "check the layout", "find binaries in the repo".
SKILL.mdUpdated May 12, 2026
ao-cyber-systems/eden-web:frontend-design
development
VerifiedTrustedCommunity
Build, review, or visually inspect web pages using Hugo templates, Tailwind CSS, and the project's brand design system. Use when the user wants to create new pages, design components, audit existing UI, review frontend code, or visually test rendered pages. Triggers on: "build the UI", "design this page", "create a page", "review the frontend", "audit the UI", "check UI consistency", "make it look good", "frontend review", "visual review", "check how it looks", "inspect the page"
SKILL.mdUpdated May 12, 2026