Skip to content

FAQ.md

Latest commit

 

History

History
53 lines (34 loc) · 5.04 KB

FAQ.md

File metadata and controls

53 lines (34 loc) · 5.04 KB
Raw

❓ FAQ & Troubleshooting

Most "how do I…" answers live in the README; this page covers what isn't documented elsewhere, plus common install issues and the framework's limits.

🤔 Why AIDD instead of your own skills?

You can write your own Claude Code skills — nothing stops you. AIDD exists because that setup is work every team repeats and re-debugs alone: the router/action split (Skill glossary entry), the plan → implement → review gating, the plugin packaging and versioning, the multi-tool support (Cursor, Copilot, Codex, OpenCode, Kilo Code). AIDD ships that scaffolding pre-built and maintained, so you start from a working SDLC loop and only author the skill content specific to your project. If your workflow doesn't match the framework's shape, CREATE_PLUGIN.md shows how to build on the same scaffolding instead of replacing it.

📦 Install, update, other tools

  • Install / first run → Quick start.
  • Update plugins → /plugin marketplace update aidd-framework, or see Versioning & updates.
  • Private repo? Yes — /plugin marketplace add just needs GitHub read access (via gh auth login or a PAT).
  • Cursor / Copilot / Codex / OpenCode / Kilo Code? Each other tool installs via its own native mechanism (project files, local plugins, or a plugin command) from the release archives. Steps per tool → Other tools.

💸 Cost and quotas

  • Does running plugins cost money? The plugins are MIT-licensed and free; the Claude calls they make consume your Anthropic plan or API balance (per-invocation on a plan, per-token on an API key).
  • Disable a plugin without uninstalling? Run /plugin and toggle it off in the Installed tab, or remove its entry from .claude/settings.json enabledPlugins (project scope) or ~/.claude/plugins/ (user scope).

🔒 Security

  • What can a plugin do? Is it safe? → Trust and safety and SECURITY.md. Plugins run commands, edit files, and call services through your AI tool — inspect a plugin's actions/, hooks/hooks.json, and .mcp.json before installing. Claude Code asks before tool calls by default.
  • Report a vulnerability → SECURITY.md (GitHub Security Advisories; never a public issue).

🤝 Contributing

🛠️ Troubleshooting

  • Marketplace doesn't show my plugins after /plugin marketplace add — refresh the cache: /plugin marketplace update aidd-framework, then open /plugin → Discover.
  • /plugin install says the plugin is unknown — the marketplace name must match the name in this repo's .claude-plugin/marketplace.json (aidd-framework). Install with /plugin install <plugin-name>@aidd-framework.
  • A private repo won't add as a marketplace — /plugin marketplace add needs read access; authenticate with gh auth login or a PAT on the machine running your AI tool.
  • My new plugin's actions don't load — run /reload-plugins in the same session, or restart the tool if a hook config changed.

🚧 Limitations (what AIDD does not do)

  • Execution depends on the workflow. The SDLC flow is autonomous by default; interactive pauses for human review at its contract, plan and outcome checkpoints.
  • Authored for Claude Code. Other tools install via their native mechanism from the release archives (Other tools); public-marketplace publishing is on the way, native parity is a roadmap item.
  • Plugins assume their own context. A skill that expects a git repo, a package.json, or a ticketing tool won't work without it — check the plugin's README.
  • No hosted service. AIDD is prompt content you install into your own tool; there is no AIDD server and no account.
  • Measurement is opt-in and local. Nothing is recorded in a project until you turn it on, and nothing leaves your machine → Measurement.

📊 Measurement

Nothing is measured until you opt in. aidd telemetry on turns it on for one project, and aidd telemetry forget --yes removes everything it kept. It counts the tokens of Claude Code sessions and sends nothing anywhere. What it asks, what it keeps and what it needs are in the plugin's README.

🆘 Still stuck?

Ask in Discussions or on Discord. For a bug, open an issue. See SUPPORT.md.