# Td Feature Integrate

> Wire builders' isolated tdmcp tool files into the shared registries, CLI, and docs as a single writer, conflict-safe, and confirm a green typecheck + build. Use when integrating/wiring/registering new tdmcp tools, adding their CLI commands, resolving build breaks after parallel feature work, or merging several builders' files into the registry without conflicts.

- **Type:** Skill
- **Install:** `agentstack add skill-hybridlabor-api-bdb-dev-optimized-agent-skills-td-feature-integrate`
- **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/td-feature-integrate

## Install

```sh
agentstack add skill-hybridlabor-api-bdb-dev-optimized-agent-skills-td-feature-integrate
```

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

## About

# td-feature-integrate — single-writer wiring

You are the one agent that edits shared files. Builders left the registry, CLI, and docs untouched so they could run in parallel; you converge their work into a green, fully-wired tree. Do it additively and conflict-safe.

## Procedure

1. **Re-verify state first.** This branch may have concurrent agents. Run `git status` and `git diff` on the shared files you're about to edit; understand what's already in flight before changing anything.
2. **Register each tool.** Add the builder's `register…` to its layer array in `src/tools/layer/index.ts`. Confirm `src/tools/index.ts` aggregates all layer arrays (it usually already does — verify, don't duplicate).
3. **Add the CLI command** in `src/cli/agent.ts`. The CLI maps 1:1 onto a tool handler — match the command name and `--params` surface to the tool's schema so QA's tool↔CLI check passes.
4. **Docs regenerate — don't hand-edit.** `docs/reference/tools.md` is produced by `scripts/gen-tool-docs.ts` from the live registry on every docs build. Never edit it by hand; just confirm the new tool appears after a regen.
5. **Confirm green.** Run `npm run typecheck` and `npm run build`. Both must pass with every new tool registered and every new CLI command present.

## Conflict-safe editing — non-negotiable

- **Edit additively.** Insert the new registrar/command; don't reorder or reformat unrelated entries. Reviewable diffs = no merge pain.
- **Stage by explicit path.** When staging, `git add ` — **never `git add -A` / `git add .`**. Parallel agents' in-flight files (and secrets) must not be swept in. This rule has bitten this repo before.
- **Don't overwrite changes you didn't make.** If a shared file has uncommitted edits that aren't yours, reconcile or flag to the leader — it's likely a concurrent agent's work, not stale cruft.
- Lint with `./node_modules/.bin/biome check .` directly (not `npm run lint` — RTK proxy false error).

## Staleness to flag for QA

A connected `mcp__tdmcp__*` server runs the **previous build** until restarted. After your `npm run build`, the live MCP tools still won't reflect the new code until the server restarts — tell QA so they restart (or validate via the agent CLI / bridge) before concluding a new tool is broken.

## Error handling

- If the build breaks, bisect to the offending feature: wire the rest, leave that one unregistered, and send its builder a precise `file:line` fix request. Don't block the whole batch on one bad file.
- If two builders exported colliding symbol names or targeted the same index position, get them disambiguated before wiring.

## Output

Updated `index.ts` / `agent.ts`; a wiring summary at `_workspace/03_integrate.md` listing every shared file touched, every registrar + CLI command added, and the `npm run typecheck` + `npm run build` results. Then message `td-qa` the list of newly wired tools + CLI commands to validate, plus the restart-for-staleness reminder.

## 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-td-feature-integrate
- 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%.