Skip to content

feat: org architecture, docs hub, and data refresh#4

Merged
avifenesh merged 9 commits intomainfrom
feature/org-docs-strategy-2
Feb 21, 2026
Merged

feat: org architecture, docs hub, and data refresh#4
avifenesh merged 9 commits intomainfrom
feature/org-docs-strategy-2

Conversation

@avifenesh
Copy link
Contributor

Summary

  • Add ORG_ARCHITECTURE.md documenting org-wide docs strategy (URL structure, frameworks, design tokens, domain plan)
  • Create /docs/ hub page linking to agentsys, agnix, and web-ctl documentation
  • Update stale data: skills.json (28 -> 33 entries), plugins.json (correct agent/skill counts, add debate plugin, activate web-ctl)
  • Change base path from /agent-sh.dev/ to / for root deployment
  • Add Docs link to Nav and Footer, improve Footer a11y with nav landmarks
  • Replace stale Starlight template README
  • Derive plugin/skill counts dynamically in pages to prevent future drift

Test Plan

  • npm run build passes (4 pages, ~1s)
  • All data counts verified against actual repo contents
  • Review loop: code quality, security, performance, test coverage, frontend/a11y
  • Deslop scan: 0 findings
  • Delivery validation: all checks passed

Closes #2

Add 10 missing skills (debate, enhance-orchestrator, enhance-agent-prompts,
enhance-claude-memory, perf-baseline-manager, perf-benchmarker, perf-profiler,
maintain-cross-platform, web-auth, web-browse). Update plugin agent/skill
counts to match actual repos. Update hero stats to 14 plugins, 43 agents,
38 skills, 230 lint rules. Mark web-ctl as active (no longer coming soon).
The site will be served at the org root (agent-sh.github.io) rather
than a project subdirectory.
Documents URL strategy, framework choices, design token ownership,
and future plans for unified search and shared components.
Add Docs link between Products dropdown and Plugins in desktop nav,
mobile menu, and footer Resources column.
Central docs page linking to agentsys, agnix, and web-ctl documentation
sites, plus resources section with plugin catalog, skills directory,
and GitHub org links.
- plugins.json: fix skill/agent counts (ship: 1 skill, audit-project: 1 skill, agnix: 1 agent)
- skills.json: remove orphan skills (enhance-agents, enhance-claudemd, baseline, benchmark, profile), fix maintain-cross-platform plugin ref
- index.astro: derive counts from data, fix em-dashes, fix title separator
- docs.astro: import data for dynamic counts, extract inline styles, fix title separator, add a11y text for external links
- plugins.astro: use dynamic plugin count, fix title separator
- Footer.astro: wrap link groups in nav elements with aria-label for a11y
- main.css: add footer nav flex layout for new nav wrappers
@avifenesh avifenesh merged commit b351f28 into main Feb 21, 2026
2 checks passed
@avifenesh avifenesh deleted the feature/org-docs-strategy-2 branch February 21, 2026 23:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Org Architecture: Documentation & Website Strategy

1 participant