paralleldrive/aidd/aidd-structure

Claude Code and agent skill by paralleldrive/aidd

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Enforces source code structuring and interdependency best practices. Use when creating folders, moving files, adding imports, or when the user asks about architecture, layering, or module dependencies.

Install

npx vskill@latest install paralleldrive/aidd/aidd-structure

SKILL.md

Standard folder structure

types ← services ← plugins ← components
↑ ↑ ↑
└─────────┴─────────┘ (types only depend on types)

Dependency rules

sudolang
LayerDependency {
layer: "components" | "plugins" | "services" | "types"
mayDependOn: String[]
mustNotDependOn: String[]
}
DependencyRules [
{ layer: "components", mayDependOn: ["plugins (Observe<Data>, void actions)", "types"], mustNotDependOn: ["services"] },
{ layer: "plugins", mayDependOn: ["services", "types", "other plugins"], mustNotDependOn: [] },
{ layer: "services", mayDependOn: ["other services", "types"], mustNotDependOn: ["components", "plugins"] },
{ layer: "types", mayDependOn: ["other types"], mustNotDependOn: ["everything else"] }
]
Constraints {
Never: components → services
Never: services → components or plugins
Never: types → anything except types
}

components

UI components or elements (also called "elements").

From plugins: only Observe<Data> for reactive re-renders and void-returning action functions.

plugins (if using @adobe/data/ecs for state)

ECS Database.Plugin declarations. Usually depend on services, types, and other plugins.

services

Asynchronous data services, each in its own folder. Immutable data only. Adhere to namespace guidelines.

Async patterns only: Observe<Data>, Promise<Data>, AsyncGenerator<Data>, void actions.

External code depends only on interfaces, never on implementations.

types

Pure functional types and associated pure functions. Adhere to namespace guidelines.

Nested structure

When a component has implementation-specific sub-parts, mirror the root structure inside it:

components/my-component/
components/
plugins/
types/

Execute

sudolang
fn whenAddingOrMovingCode() {
Constraints {
Place code in the correct layer (components, plugins, services, types)
Check dependencies against the dependency rules
Fix any violations (e.g. components importing services)
}
}

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
374
Repository forks
30
Repository npm downloads, 7 days
945
7-day trend score
46

Stars and forks are for the whole GitHub repository, not this skill alone. Downloads are for the repository's npm package. Refreshed 28 Apr 2026, 6 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/paralleldrive/aidd/aidd-structure/badge)](https://verified-skill.com/skills/paralleldrive/aidd/aidd-structure)

Something wrong with this skill or its page? Tell us.