{"id":45768892,"url":"https://github.com/bcbeidel/wos","last_synced_at":"2026-04-14T04:00:35.576Z","repository":{"id":339251155,"uuid":"1160478889","full_name":"bcbeidel/wos","owner":"bcbeidel","description":"[Experimental] Claude Code plugin for building and maintaining structured project context","archived":false,"fork":false,"pushed_at":"2026-04-08T02:20:52.000Z","size":2045,"stargazers_count":1,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-08T04:16:46.438Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bcbeidel.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-18T01:41:10.000Z","updated_at":"2026-04-08T02:21:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bcbeidel/wos","commit_stats":null,"previous_names":["bcbeidel/wos"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/bcbeidel/wos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcbeidel%2Fwos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcbeidel%2Fwos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcbeidel%2Fwos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcbeidel%2Fwos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bcbeidel","download_url":"https://codeload.github.com/bcbeidel/wos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcbeidel%2Fwos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31781292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-26T04:27:45.641Z","updated_at":"2026-04-14T04:00:35.570Z","avatar_url":"https://github.com/bcbeidel.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wos\n\n\u003e **Experimental** — This project is under active development. APIs, skill interfaces, and document conventions may change without notice.\n\nA Claude Code plugin for building and maintaining structured project context\nwith AI-assisted research, source verification, and quality validation.\n\n## What It Does\n\nWOS helps teams create and maintain a structured knowledge base alongside their\ncode. It provides skills for creating context documents, verifying sources,\nand auditing quality — so agents can find what they need and trust what they\nfind.\n\n**Structured context** — Documents have YAML metadata (`name`, `description`,\noptional `type`, `sources`, `related`). Auto-generated `_index.md` files\nprovide lookup tables at every directory level.\n\n**Research quality** — The SIFT framework guides source evaluation. Source URLs\nare verified programmatically (HTTP HEAD/GET) at creation time and during\naudit. Research documents require non-empty `sources` lists.\n\n**Agent navigation** — AGENTS.md contains a WOS-managed section\n(`\u003c!-- wos:begin --\u003e` / `\u003c!-- wos:end --\u003e`) with navigation instructions,\nan areas table, metadata format, and communication preferences.\n\n## Skills\n\nWOS provides 13 active skills organized into four layers — knowledge, delivery,\ninfrastructure, and feedback. See [OVERVIEW.md](OVERVIEW.md) for the full\nskill ecosystem diagram, lifecycle descriptions, and reference table.\n\n## Project Structure\n\n```\nwos/\n  document.py          # Document dataclass + parse_document()\n  frontmatter.py       # Custom YAML subset parser (stdlib-only)\n  index.py             # _index.md generation + sync checking\n  validators.py        # 8 validation checks\n  url_checker.py       # HTTP HEAD/GET URL reachability\n  agents_md.py         # Marker-based AGENTS.md section management\n  markers.py           # Shared marker-based section replacement\n  preferences.py       # Communication preferences capture\n  research_protocol.py # Search protocol logging\nscripts/\n  lint.py              # CLI: run validation, offer fixes\n  reindex.py           # CLI: regenerate all _index.md files\n  deploy.py            # CLI: export skills to .agents/ for cross-platform use\n  check_url.py         # CLI: URL reachability checking\n  update_preferences.py # CLI: update communication preferences\n  get_version.py       # CLI: print plugin version\nskills/                # Skill definitions (SKILL.md + references/)\n  _shared/references/  # Shared references (research, distill pipelines)\ntests/                 # pytest tests\ndocs/                  # Documentation, plans, and research\n  context/             # Topic areas (created by /wos:setup)\n  plans/               # Design docs and implementation plans\n  research/            # Research artifacts\n```\n\n## Usage\n\n```bash\nclaude --plugin-dir /path/to/wos\n```\n\nOr add to Claude Code settings for automatic loading.\n\n## Cross-Platform Deployment\n\nWOS skills can be deployed to GitHub Copilot, Cursor, Windsurf, Codex,\nGemini CLI, and other platforms. See [DEPLOYING.md](DEPLOYING.md) for\nthe full guide.\n\n```bash\npython scripts/deploy.py --platform copilot   # or --target /path/to/project\n```\n\n## Script Invocation\n\nAll scripts use [PEP 723](https://peps.python.org/pep-0723/) inline metadata\nand are invoked via `python`. No external runtime dependencies — stdlib only.\nDev dependencies (pytest, ruff) install via `pip install -e \".[dev]\"`.\n\n## Dependencies\n\n- Python 3.9+\n- No runtime Python dependencies (stdlib only for `wos/` package)\n- `gh` CLI (for report-issue skill)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcbeidel%2Fwos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbcbeidel%2Fwos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcbeidel%2Fwos/lists"}