# Tdmcp Docs Roadmap Update

> >

- **Type:** Skill
- **Install:** `agentstack add skill-hybridlabor-api-bdb-dev-optimized-agent-skills-tdmcp-docs-roadmap-update`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hybridlabor-api](https://agentstack.voostack.com/s/hybridlabor-api)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [hybridlabor-api](https://github.com/hybridlabor-api)
- **Source:** https://github.com/hybridlabor-api/bdb-dev-optimized-agent-skills/tree/main/mcps/tdmcp/.claude/skills/tdmcp-docs-roadmap-update

## Install

```sh
agentstack add skill-hybridlabor-api-bdb-dev-optimized-agent-skills-tdmcp-docs-roadmap-update
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# tdmcp-docs-roadmap-update

Updates the repo's documentation surfaces after feature waves or releases:
`docs/ROADMAP.md`, high-level docs named by the audit, EN/PT prompt cookbooks,
and generated reference docs.

**Execution mode:** sub-agents. This environment does not use `TeamCreate`;
spawn the role agents defined in `.claude/agents/` and coordinate them from the
main session.

## Phase 0: Context Check

Before spawning agents:

1. Inspect `git status --short`.
2. Check whether `_workspace/docs_release_audit.md`,
   `_workspace/roadmap_docs_update.md`, `_workspace/cookbook_sync_update.md`, or
   `_workspace/docs_roadmap_qa.md` already exist.
3. Decide execution mode:
   - no prior workspace files -> full run;
   - prior files + user says update/re-run/continue -> refresh only affected
     phases;
   - prior files + new release/tag/feature input -> refresh audit first, then
     re-run writers.

Preserve unrelated local changes. Do not reset or revert user edits.

## Phase 1: Release And Feature Audit

Spawn `docs-release-auditor`:

```text
Read .claude/agents/docs-release-auditor.md and execute it.
Audit current local package, CHANGELOG, ROADMAP, README, cookbook docs,
CLI/resource surfaces, generated docs, npm package version, GitHub releases, and
tags. Write _workspace/docs_release_audit.md.
```

The audit is mandatory whenever release wording, tool counts, or "latest"
features are involved.

## Phase 2: Docs Writing

After `_workspace/docs_release_audit.md` exists, spawn these agents in parallel
when their write sets are both needed:

**Roadmap/docs editor**

```text
Read .claude/agents/roadmap-docs-editor.md and execute it.
Use _workspace/docs_release_audit.md. Update docs/ROADMAP.md and any high-level
docs named by the audit. Do not edit generated docs or cookbook files. Write
_workspace/roadmap_docs_update.md.
```

**Cookbook sync**

```text
Read .claude/agents/docs-cookbook-sync.md and execute it.
Use _workspace/docs_release_audit.md and _workspace/roadmap_docs_update.md if it
exists. Update docs/guide/prompt-cookbook.md and docs/pt/guide/prompt-cookbook.md
for docs-worthy new features, keeping locales in parity. Write
_workspace/cookbook_sync_update.md.
```

If only roadmap docs or only cookbook docs are affected, run only the relevant
writer.

## Phase 3: Generated Docs And QA

Run the docs generation/build gate from the main session:

```bash
npm run docs:build
npm run validate:recipes
git diff --check
```

Then spawn `docs-roadmap-qa`:

```text
Read .claude/agents/docs-roadmap-qa.md and execute it.
Use the release audit and writer summaries. Verify release claims, EN/PT parity,
generated docs behavior, VitePress media embeds, and command outcomes. Write
_workspace/docs_roadmap_qa.md.
```

If QA finds narrow issues, fix them in the main session or re-run only the
responsible writer.

## Data Flow

- Auditor writes `_workspace/docs_release_audit.md`.
- Roadmap editor writes `_workspace/roadmap_docs_update.md`.
- Cookbook sync writes `_workspace/cookbook_sync_update.md`.
- QA writes `_workspace/docs_roadmap_qa.md`.
- Final docs edits remain in normal repo files.

## Quality Rules

- Verify live release state before claiming a public version is current.
- Keep public release, local `HEAD`, and planned backlog distinct.
- Never hand-edit generated `docs/reference/tools.md`.
- Keep EN/PT cookbook examples in parity.
- Use `withBase('/examples/...')` for VitePress video embeds.
- Treat missing media assets as description-only or explicit follow-up, not as
  silent broken links.

## Test Scenarios

**Normal flow:** a new release lands. Audit confirms package/npm/GitHub agree,
roadmap is updated with shipped and remaining work, cookbook gets matching EN/PT
entries, `npm run docs:build`, `npm run validate:recipes`, and
`git diff --check` pass.

**Error flow:** npm or GitHub release checks fail. Auditor marks release state
unverified; writers avoid definitive public-release claims; QA records residual
risk and asks for a retry or human release confirmation.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hybridlabor-api](https://github.com/hybridlabor-api)
- **Source:** [hybridlabor-api/bdb-dev-optimized-agent-skills](https://github.com/hybridlabor-api/bdb-dev-optimized-agent-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hybridlabor-api-bdb-dev-optimized-agent-skills-tdmcp-docs-roadmap-update
- Seller: https://agentstack.voostack.com/s/hybridlabor-api
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.