opsward#

Diagnose, generate, and maintain the AI agent setup of your projects.

Modules

base

All dataclasses and type definitions for opsward.

cli

CLI dispatch for opsward.

data

Bundled package resources for opsward, accessed via importlib.resources.files("opsward.data").

decisions

Decision capture: numbered ADRs, the one-line decision log, and their drift.

discover

Optional cross-repo asset discovery, delegating to the toolery package.

evals

Eval harness (opsward#17, gap 3): opt-in, report-only quality signals beyond the rubric.

fleet(roots, *[, diagnose_root, check_dirs])

Diagnose every root and aggregate.

generate(scan_result, *[, agents_md, hooks])

Determine which artifacts are missing, render templates, return files to create.

lint

Schema lint (opsward#17, gap 2): spec and config violations, pass or fail, no score.

maintain(scan_result, *[, previous_report, ...])

Detect maintenance issues and return suggestions.

portability

Multi-host portability: which agent hosts a repo satisfies, and canonical↔render drift.

recommend

Recommend skills from the ecosystem based on project tech stack.

scan(project_root, *[, claude_config_dir])

Scan project_root and return a ScanResult.

score

Pure scoring functions.

security

Security advisories (opsward#17, gap 5): "valid" is not "safe to ship".

subagents

Reuse a skill as a subagent: declare it in the skill, generate the twin, check the sync.

util

Shared helpers for opsward.