Coding guidelines spac as ssot

[jamesricky]

The coding guidelines currently live as hand-written pages, primarily for human consumption.

This PR introduces spec/standards/coding-guidelines/ as the single source of truth – granular, tool-agnostic markdown files (one per topic, same content as the current docs).

The "coding-guidelines" spec defines how to generate the following from these standards:

• The same docs pages, as currently exist
• An agent skill

[nsams]

how do you convert it into the other formats? Using AI? That would be a slow and error prone workflow imho

[jamesricky]

how do you convert it into the other formats? Using AI? That would be a slow and error prone workflow imho

I'm just experimenting with Spec-Driven Development, currently have no intention to merge this.

The goal would be to have a single, extremely detailed source for all guidelines, then use AI generate human readable docs and a skill from that source.

That would be a slow and error prone workflow imho

That's what I intend to figure out 🙂