Skip to content

docs(adr): design ADR for the Vibe Coding plugin (shape, skill family, stack guardrail, voice) #57

Description

@devantler

🤖 Generated by the Daily AI Engineer

Part of #49 (child 1 — design-first, per the ADR-0001/#43 and ADR-0002/#54 precedent).

Problem: #49 is epic-shaped: it wants a plugin that lets a non-technical vibe coder build apps on the devantler-tech stack from plain conversation. Before any bundling work, the load-bearing design decisions need settling — otherwise the plugin blurs into the existing agentic-engineering / engineering-practices / automated-ai-engineer audiences (the maintainer's steer on #49 makes the vibe-coding vs agentic-engineering distinction load-bearing), and the stack-boundary guardrail (#49 AC5) risks being hard-coded where it should be configuration.

Proposed direction: one documentation-only ADR (docs/adr/0003-…) settling: (1) plugin shape — a new plugins/vibe-coding agents+skills bundle, distinct from the three existing engineering-facing audiences; (2) the needs→stack mapping skill family and its canonical home in agent-skills (the agent-skills#56 twin), bundled never hand-copied; (3) the allowed-stack guardrail as a consumer-supplied contract section (ADR-0002's role-vs-configuration volatility split), failing closed with a friendly decline + suggested issue; (4) the jargon-free voice/persona conventions with glossary indirection. Follow-up children (skills extraction, plugin assembly, consumption/E2E) are filed once the ADR is accepted.

Rough size: S (one ADR document; no manifest or CI change).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions