Back to the catalog

Repository Knowledge Graph

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

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

About

# Repository Knowledge Graph

Read progressively: index → relevant standard → project-specific concept.

## Shared standards

- [Coding practices](standards/coding-practices.md)
- [Architecture](standards/architecture.md)
- [Security](standards/security.md)
- [Testing](standards/testing.md)
- [Verification](standards/verification.md)
- [Dependencies](standards/dependencies.md)
- [Change safety](standards/change-safety.md)

## Add project knowledge

Document the repository’s architecture, workflows, integrations, operations, and design only when grounded in current source. Use linked concept pages instead of expanding `AGENTS.md`.

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:04:09
Updated
2026-09-08 16:04:09
Origin id
jondoescoding/jondoescoding-coding-rules:blueprints/codex/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