Skip to content

Commit 9532b2d

Browse files
committed
✨ add new documentation pages for JSONC specification and rulesync tool
📝 update journal entry to include rulesync and JSONC references for improved tracking of related tools and specs
1 parent 69fd3d2 commit 9532b2d

File tree

3 files changed

+57
-1
lines changed

3 files changed

+57
-1
lines changed

journals/2025_09_29.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
1+
- [[rulesync]]
12
- [[Person/Alex Reibman]]
23
- [areibman/bottleneck: Native Electron app for reviewing pull requests dramatically faster than Github web. Specialized for handling reviews for background agents working on multiple concurrent threads](https://github.com/areibman/bottleneck)
34
- [[Anthropic/App/Claude Code/GitHub/claude-code-docs]]
45
- [ericbuess/claude-code-docs](https://github.com/ericbuess/claude-code-docs)
5-
- Local mirror of Claude Code documentation files from [https://docs.anthropic.com/en/docs/claude-code/](https://docs.anthropic.com/en/docs/claude-code/), updated every 3 hours.
6+
- Local mirror of Claude Code documentation files from [https://docs.anthropic.com/en/docs/claude-code/](https://docs.anthropic.com/en/docs/claude-code/), updated every 3 hours.
7+
- [[json/jsonc]] - Created page for JSONC (JSON with Comments) specification, related to [[json/5]]

pages/json___jsonc.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
- # [JSONC | JSONC Specification](https://jsonc.org/)
2+
- ## About
3+
id:: 67c822b0-3271-41da-a14f-4f023a1f4556
4+
- JSONC (JSON with Comments) is an extension of [[json]] that allows comments within JSON data. This specification defines the syntax and semantics of JSONC.
5+
- The JSONC format was informally introduced by Microsoft to be used for VS Code's configuration files (`settings.json`, `launch.json`, `tasks.json`, etc). Alongside the informal format, a publicly-available parser ([`jsonc-parser`](https://www.npmjs.com/package/jsonc-parser)) was supplied to parse those configuration files. The goal of this specification is to formalize the JSONC format as what [`jsonc-parser`](https://www.npmjs.com/package/jsonc-parser) considers valid while using its default configurations.
6+
- JSONC follows the same syntax rules as JSON with the addition of JavaScript style comments. Comments can be either single-line or multi-line.
7+
- ## Comparison with [[json/5]]
8+
- Both JSONC and [[json/5]] extend JSON to support comments, but they have different approaches:
9+
- **JSONC**: Minimal extension - adds only comments to standard JSON
10+
- **JSON5**: Comprehensive extension - adds comments, unquoted keys, trailing commas, and other JavaScript-like features
11+
- JSONC is more conservative and maintains closer compatibility with standard JSON
12+
- JSON5 is more permissive and allows more JavaScript-like syntax
13+
- ## #Example
14+
- ```jsonc
15+
{
16+
// This is a single-line comment
17+
"name": "example",
18+
"value": 42,
19+
/* This is a
20+
multi-line comment */
21+
"enabled": true
22+
}
23+
```
24+
- ## Use Cases
25+
- Configuration files in development tools (especially VS Code)
26+
- Documentation within JSON data structures
27+
- Human-readable JSON files that benefit from explanatory comments
28+
- ## Related
29+
- [[json/5]] - Alternative JSON extension with broader syntax support
30+
- [[json]] - Standard JSON format
31+
- [jsonc-parser](https://www.npmjs.com/package/jsonc-parser) - Official parser implementation

pages/rulesync.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# [dyoshikawa/rulesync](https://github.com/dyoshikawa/rulesync?tab=readme-ov-file#supported-tools-and-features)
2+
- > A Node.js CLI tool that automatically generates configuration files for various AI development tools from unified AI rule files. Features selective generation, comprehensive import/export capabilities, and supports major AI development tools with rules, commands, MCP, ignore files, and subagents. Uses the recommended `.rulesync/rules/*.md` structure, with full backward compatibility for legacy `.rulesync/*.md` layouts.
3+
- Rulesync supports both **generation** and **import** for All of the major AI coding tools:
4+
| Tool | rules | ignore | mcp | commands | subagents |
5+
| ---- | ---- | ---- |
6+
| AGENTS.md | ✅ | | | | |
7+
| Claude Code | ✅ | ✅ | ✅ | ✅ | ✅ |
8+
| Codex CLI | ✅ | ✅ | | 🎮 | 🎮 |
9+
| Gemini CLI | ✅ | ✅ | | ✅ | 🎮 |
10+
| GitHub Copilot | ✅ | | ✅ | 🎮 | 🎮 |
11+
| Cursor | ✅ | ✅ | ✅ | ✅ | 🎮 |
12+
| OpenCode | ✅ | | | | |
13+
| Cline | ✅ | ✅ | ✅ | | |
14+
| Roo Code | ✅ | ✅ | ✅ | ✅ | 🎮 |
15+
| Qwen Code | ✅ | ✅ | | | |
16+
| Kiro IDE | ✅ | ✅ | | | |
17+
| Amazon Q Developer CLI | ✅ | | ✅ | | |
18+
| JetBrains Junie | ✅ | ✅ | | | |
19+
| AugmentCode | ✅ | ✅ | | | |
20+
| Windsurf | ✅ | ✅ | | | |
21+
| Warp | ✅ | | | | |
22+
- 🎮: Simulated Commands/Subagents (Experimental Feature)
23+
-

0 commit comments

Comments
 (0)