Work management
Bundle OKF 0.2 · 5 conceitos · agentxm/axm
Open source Repository Open in the app JSON README (API)
About
# Work management
Portable concepts, guides, and templates for consistent software work items.
Use this bundle to classify, author, relate, maintain, and verify Operational
Incident Records, Defect Reports, and Changes without adopting a particular
tracker, delivery method, requirements system, or architecture framework.
## Foundations
- [Software work-item taxonomy](software-work-item-taxonomy.md) - Defines the
portable work-item roles, classifications, neighboring activities, and
distinctions that every guide and template in this bundle applies.
- [Common work-item guidance](common/) - Shared content, evidence, identity,
lifecycle, verification, tracker-mapping, local-policy, technical-context,
and brief-authoring guidance.
## Work-item roles
- [Defect Reports](defects/) - Concepts, authoring, triage, corrective-change
relationships, and a portable template for observations that may indicate a
defect.
- [Changes](changes/) - Concepts, classification, authoring, and a portable
te
Details
- Kind
- OKF bundles
- Topic
- Cloud & DevOps
- Publisher
- agentxm
- Origin
- okf_github
- Category
- dados
- Version
- 0.2
- Stars
- 5
- Last push
- 2026-09-08T22:31:00Z
- Repository state
- ativo
- Language
- TypeScript
- License
- NOASSERTION
- Added
- 2026-09-08 22:08:51
- Updated
- 2026-09-08 22:08:51
- Origin id
agentxm/axm:agent_extensions/agentxm/@craigsmitham/knowledge/work-management/src/index.md
README
``` ▄▀█ ▀▄▀ █▀▄▀█ █▀█ █ █ █ ▀ █ Agent Extension Manager by AgentXM https://axm.sh | https://agentxm.ai ```  [](https://www.npmjs.com/package/axm.sh) [](https://github.com/agentxm/axm/actions/workflows/ci.yml) [](./LICENSE) # Extension manager for coding agents and AI assistants - Manage agent skills, subagents, MCP servers, rules, hooks, knowledge, and packs. - Bundle extensions with packs to share workflows across projects, teams, and others. - Switch effortlessly between coding agents, bringing your workflow with you. Avoid lock-in. > [!WARNING] > AXM is in **early alpha** testing. Capabilities and APIs may change. To be > included in the test user group, reach out to > [hello@agentxm.ai](mailto:hello@agentxm.ai). - **Multi-tool** — a unified context-engineering toolkit for managing skills, subagents, MCP servers, rules, hooks, knowledge, and packs - **Multi-agent** — share workflows across Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, and [nearly 40 others](#supported-agents) - **Cross-platform** — discover and distribute agent skills and extensions across package ecosystems including JavaScript, Python, Java, .NET, Go, Rust, Ruby, and more ## Installation **Ask your agent to install AXM:** ``` Follow these install instructions to set up AXM: https://axm.sh/install.md ``` **macOS / Linux:** ```bash curl -fsSL https://axm.sh/install.sh | sh ``` **Windows (PowerShell):** ```powershell irm https://axm.sh/install.ps1 | iex ``` **Windows (CMD):** ```cmd curl -fsSL -o install.cmd https://axm.sh/install.cmd && install.cmd ``` **Homebrew:** ```bash brew install agentxm/tap/axm ``` **npm:** ```bash npm install -g axm.sh ``` ## Getting started Initialize AXM in your project. AXM detects your installed agents and creates root `axm.json`; acquired packages and accepted external resolutions are kept in `agent_extensions/` and `axm-lock.yaml`, while `.axm/` is runtime scratch. AXM leaves Git attributes and formatter policy to the repository; exclude `agent_extensions/` from tools that rewrite files. ```bash axm setup ``` See what's recommended for your project: ```bash axm discover ``` Install an extension and AXM wires it into every agent in your workspace: ```bash axm install @acme/skills/code-review ``` ## Extension types <!-- axm:generated:extension-types-table --> | Type | What it is | Governing standard | | --------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | **Skills** | Package reusable agent skills with SKILL.md metadata and instructions. | [Agent Skills](https://agentskills.io) | | **MCP Servers** | Configure Model Context Protocol servers for agents. | [Model Context Protocol](https://modelcontextprotocol.io) | | **Subagents** | Install specialized agent profiles into an agent's native subagent system. | — | | **Rules** | Sync instruction files and distribute rule extensions that inject into them. | [AGENTS.md](https://agents.md) | | **Hooks** | Install lifecycle hook extensions into an agent's native hook system. | — | | **Knowledge** | Package portable Open Knowledge Format concept bundles. | [Open Knowledge Format 0.2](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) | <!-- /axm:generated --> **Packs** are the container type: a pack curates any of the above into one bundle teams install and keep in sync, such as `@acme/packs/frontend-tools` — the frontend guild's standard skills and commands. <!-- axm:generated:extension-type-namespaces --> Every type has its own subcommand namespace (`axm skills`, `axm mcps`, `axm subagents`, `axm rules`, `axm hooks`, `axm knowledge`, `axm packs`) sharing a common shape: `install`, `uninstall`, `list`, `update`, `new`, `publish`, plus `enable`/`disable` where it applies. <!-- /axm:generated --> ## Subcommands Examples below use `skills`; the same shape applies to every type. ```bash axm skills new my-skill # Scaffold a new skill axm skills install @acme/skills/code-review axm skills list axm skills disable my-skill # Turn off without uninstalling axm skills enable my-skill axm skills import ./external-skill @acme/skills/my-skill axm fork @acme/skills/code-review @me/skills/code-review-custom axm skills publish # Publish authored skills ``` Installed and enabled skills are always materialized in `.agents/skills/` for the agentskills.io format, plus any declared agent-native skill directories. `axm packs` adds bundling commands: ```bash axm packs add my-pack @acme/skills/code-review axm packs add my-pack "effect-*" # Add all matching extensions ``` Run `axm --help` for the top-level command list, or `axm <command> --help` for options on any subcommand. ## Workspace Top-level commands work across every extension type and infer the target from your input: ```bash axm install # Sync extensions from axm.json axm install @acme/skills/code-review # Install a single extension axm update # Pull latest versions axm list # Inventory extensions across all types axm list --outdated # Show extensions with available updates axm list --deprecated # Show deprecated installed extensions axm uninstall @acme/skills/code-review axm adopt @acme/skills/retained-package # Make a canonical package authoritative axm demote @acme/skills/review ./upstream # Explicitly return to external source management axm lint # Report intrinsic workspace facts axm sync --preview # Preview reconciliation without writing axm sync # Reconcile desired, accepted, and observed state axm upgrade # Update axm itself ``` ## Publishing Extensions publish to the registry in four steps. ```bash axm skills new my-skill # 1. Scaffold # 2. Author content in the scaffolded directory axm lint # 3. Check the publish gate locally axm publish # 4. Publish new authored versions; verify existing ones ``` Authorship is derived from the exact intrinsic `workspace` settings source, the project `owner`, the settings map key, the extension type, and the matching manifest in that type's authored root. Bare, filtered, and explicit selections publish only workspace-authored packages. Adopt a retained canonical package when this workspace should own it, or fork an installed package to publish it under a new identity. AXM builds a deterministic archive from each selected authored package. For an existing immutable version, `--on-existing verify` rebuilds that archive and requires its SHA-512 digest to match the Registry release before reporting a successful no-op. Installed external packages represent the source identity recorded in `axm-lock.yaml`. `axm lint` checks their current contents against that accepted identity. Publication reads workspace-authored packages. `axm lint` checks the same rules the registry enforces — see [Lint](#lint) for details. ## Lint `axm lint` evaluates workspace and per-extension invariants against a shared rule catalog — the same one that drives the registry publish gate. ```bash axm lint # Report findings against the current project axm lint --fix # Apply every autofixable finding non-interactively axm lint --scope user # Lint the user-scope workspace axm lint --strict # Exit non-zero on warnings as well as errors axm lint --json # Machine-readable findings envelope ``` Project scope is the default. Local `lint.rules` overrides in `axm.json` affect `axm lint` only — the registry publish gate remains authoritative. ## Authentication Sign in to a registry to publish, install private extensions, or attribute usage to your account: ```bash axm login # Sign in to the default registry axm login --device-code # Sign in from SSH or a headless machine axm whoami # Show the current identity axm logout axm token # Print the current token (for scripting) ``` `axm login` starts a local loopback PKCE flow, prints a manual authorization URL, and then tries to open your browser. SSH, CI, and Codespaces automatically use device-code sign-in; pass `--device-code` to select that flow explicitly. Device-code sign-in opens a complete authorization link when possible and also shows the clean fallback page plus the one-time code. Retrying the command reuses the same unexpired request; use `--restart` only when you intentionally want to replace it. Never enter a code that another person or website gave you. ## Supported agents AXM supports nearly 40 agents — Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Windsurf, Cline, Continue, Roo, Goose, and more. If your agent isn't there, [open an issue](https://github.com/agentxm/axm/issues) and we'll add it. ## Development This is an Nx monorepo. ```bash pnpm install # Install dependencies pnpm build # Build all packages pnpm test # Run tests pnpm typecheck # Type check pnpm lint # Lint ``` Use `pnpm build:affected`, `pnpm test:affected`, or `pnpm lint:affected` to only operate on packages changed since `main`. See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full development workflow. --- **Open Agents, Open Standards, Open Source.** ## License AXM is licensed under the [Functional Source License](https://fsl.software/) (FSL), a [Fair Source](https://fair.io) license that converts to a MIT license after two years. FSL-1.1-MIT © 2025-2026 AgentXM, Inc. — see [LICENSE](./LICENSE).