Back to the catalog

Coding Rules Knowledge Graph

Bundle OKF 0.1 · 4 conceitos · jondoescoding/jondoescoding-coding-rules

Open source Repository Open in the app JSON README (API)

About

# Coding Rules Knowledge Graph

This repository initializes projects with Jonathan's Codex-ready standards and a lean linked knowledge graph. Cursor and Claude templates remain as a compatibility library.

## Start here

- [Architecture](architecture.md): how templates move from this package into a project.
- [Template standard](template-standard.md): how rules should be scoped, written, and maintained.
- [Contributing](contributing.md): the safe edit, validation, and release workflow.
- [Canonical standards](../standards/coding-practices.md): the installable rules derived from Prompt Bank.

## Product boundary

`standards/` is the canonical rule source. `blueprints/codex/` contains the lean router and graph index installed around those rules. `templates/` holds legacy target-specific material.

Details

Kind
OKF bundles
Topic
AI, RAG & memory
Publisher
jondoescoding
Origin
okf_github
Category
dados
Version
0.1
Stars
2
Last push
2026-07-26T21:25:21Z
Repository state
ativo
Language
JavaScript
License
MIT
Added
2026-09-08 16:02:35
Updated
2026-09-08 16:02:35
Origin id
jondoescoding/jondoescoding-coding-rules:docs/index.md

README

# JonDoesCoding Repository Standards

Use this repository to initialize a new codebase with Jonathan’s default coding, architecture, security, testing, verification, dependency, and change-safety standards.

## Give this to Codex

Paste the repository URL and this instruction:

```text
Read the README in https://github.com/jondoescoding/jondoescoding-coding-rules.
Initialize this repository with Jonathan's coding standards.
Inspect the existing repo first, preserve its conventions and dirty changes,
install the standards without overwriting conflicts, then adapt docs/index.md
with project-specific architecture, commands, integrations, and verification.
Keep AGENTS.md lean.
```

## Initialize a repository

From the target repository:

```powershell
npx jondoescoding-coding-rules init --dry-run
npx jondoescoding-coding-rules init
```

The dry run shows every path before writing. Normal initialization refuses to overwrite different existing files. Use `--force` only after reviewing those conflicts.

## What gets installed

```text
AGENTS.md
docs/
  index.md
  standards/
    architecture.md
    change-safety.md
    coding-practices.md
    dependencies.md
    security.md
    testing.md
    verification.md
```

`AGENTS.md` is intentionally short. It routes agents into a linked knowledge graph, meaning a set of small Markdown concepts connected with normal links.

## Standards

- [Coding practices](standards/coding-practices.md): minimize cognitive load and unnecessary abstraction.
- [Architecture](standards/architecture.md): UI, hooks, domain modules, adapters, and provider boundaries.
- [Security](standards/security.md): server-derived identity, authorization, validation, rate limits, secrets, and safe errors.
- [Testing](standards/testing.md): confidence over coverage and tests through stable interfaces.
- [Verification](standards/verification.md): targeted checks, authoritative checks, builds, and real browser proof.
- [Dependencies](standards/dependencies.md): reachable imports, official docs, and verified dead-code removal.
- [Change safety](standards/change-safety.md): preserve dirty work, scope git actions, and record durable knowledge.

These principles were extracted from the most mature conventions in Prompt Bank, then generalized so they do not assume its routes, vendors, database, or framework.

## Existing Cursor and Claude templates

The older template library remains available:

```powershell
npx jondoescoding-coding-rules legacy --type cursor
npx jondoescoding-coding-rules legacy --type cursor seo/seo-best-practices
npx jondoescoding-coding-rules legacy --type claude-code --all
```

## Develop

```powershell
npm test
npm pack --dry-run
```

Start at [docs/index.md](docs/index.md) for this repository’s own knowledge graph.

More