janjaali/janjaali-agent-plugin
Reusable, agent-agnostic skills: general code and markdown conventions, Scala development conventions, and a spec-driven development workflow.
General conventions for writing and documenting code and markdown in any language or repo. Covers markdown formatting (uppercase filenames, no hard-wrapped prose), code structure, doc comments, why-comments, ~80-column line width, and no trailing commas. Applies whenever generating, editing, or reviewing source code, configuration, or markdown files.
Git conventions for agents. Defines when an agent may stage, commit, and push, and the commit message format. Applies whenever an agent is about to stage, commit, or push, or is writing or proposing a commit message, regardless of repo or language.
Scala development conventions for writing or reviewing Scala code and related configuration. Covers test structure, Scalafix/Scalafmt file hygiene, immutable sequence literal style, exhaustive pattern matching, validation object return types, and HOCON comment syntax.
**WORKFLOW SKILL** — Interview the user about specification changes and generate one or more standalone SPEC.md documents (one per spec folder) that serve as a high-level overview of the component or process: contract, behavior, and business intent, captured as user stories and EARS-notation acceptance criteria. Technical architecture, diagrams, and implementation-level detail live in companion documents (DESIGN.md, DOMAIN.md, DATABASE.md, KAFKA.md, CONVENTIONS.md). The agent uses SPEC.md plus companion documents together for planning and code generation.