Skip to content

AGENTS.md

Latest commit

 

History

History
91 lines (66 loc) · 3.84 KB

AGENTS.md

File metadata and controls

91 lines (66 loc) · 3.84 KB

AGENTS.md

Guidance for AI coding agents working on the Docker Developer Tools repository.

Repository overview

A Cursor IDE plugin providing Docker and container workflows. 17 skills, 10 rules, and 150 MCP tools for building, debugging, optimizing, and managing Docker containers, images, networks, and volumes. Includes a companion MCP server (@tmhs/docker-mcp) for live Docker CLI integration.

Docs site: https://tmhsdigital.github.io/Docker-Developer-Tools/

Repository structure

Docker-Developer-Tools/
  .cursor-plugin/plugin.json   # Plugin manifest (name, version, description)
  skills/                      # 17 skill directories, each with SKILL.md
  rules/                       # 10 rule files (.mdc)
  mcp-server/                  # Companion MCP server (Node.js/TypeScript)
    src/                       # Server source code
    dist/                      # Compiled output
  mcp-tools.json               # MCP tool catalog (150 tools, manually maintained)
  site.json                    # GitHub Pages branding/config
  docs/                        # Generated GitHub Pages site (do not edit manually)
  assets/                      # Logo and images
  tests/                       # Test suite
  .github/workflows/           # CI/CD (ci, codeql, dep-review, links, pages, publish, release-drafter, stale, validate)

Branching and commit model

  • Single branch: main only
  • Conventional commits: feat:, fix:, chore:, docs:

Skills

Each skill lives in skills/<skill-name>/SKILL.md. Every SKILL.md starts with YAML frontmatter:

---
name: skill-name
description: One-line description of what the skill does
---

The name and description fields are parsed by the site template build system to generate the GitHub Pages site. The body below the frontmatter contains the full skill content.

When adding a new skill:

  1. Create skills/<skill-name>/SKILL.md with frontmatter
  2. Update the skills count in .cursor-plugin/plugin.json
  3. Use feat: commit prefix

Rules

Rules are .mdc files in rules/. Each starts with YAML frontmatter containing description and globs fields. When adding a new rule, update the rules count in context references.

MCP Tools

mcp-tools.json is a manually maintained JSON array of all MCP tools. Each entry has name, description, and category fields. This file is used by the GitHub Pages build system to render the tools catalog. When adding or removing tools from mcp-server/, update this file accordingly.

GitHub Pages

The docs site is auto-generated. Do not edit docs/index.html directly. It is built by the shared template system from the Developer-Tools-Directory repo.

Data sources:

  • .cursor-plugin/plugin.json -- metadata (name, version, description)
  • site.json -- branding (accent color, install steps, links)
  • skills/*/SKILL.md -- parsed for name/description via frontmatter
  • rules/*.mdc -- parsed for name/scope/description
  • mcp-tools.json -- tool catalog

The pages.yml workflow clones Developer-Tools-Directory, runs build_site.py, and deploys the output. Changes to skills, rules, mcp-tools.json, site.json, plugin.json, or assets trigger a rebuild.

CI/CD workflows

  • ci.yml -- runs tests on push/PR
  • validate.yml -- validates plugin.json schema, checks docs
  • pages.yml -- builds and deploys GitHub Pages via shared template
  • publish.yml -- publishes MCP server to npm
  • codeql.yml -- security scanning
  • dependency-review.yml -- audits PR dependencies
  • release-drafter.yml -- auto-drafts release notes
  • stale.yml -- marks/closes inactive issues and PRs
  • links.yml -- checks for broken links

Key conventions

  • No em dashes or en dashes -- use hyphens or rewrite
  • No hardcoded credentials, tokens, or API keys
  • Conventional commits required
  • CC-BY-NC-ND-4.0 license
  • All content written for public readership