Skip to content

shimo4228/zenn-content

Repository files navigation

Language: English | 日本語

zenn-content

Ask DeepWiki GitMCP

Bilingual (JA/EN) essay corpus on AI agent design, coding-agent workflows, and authorship under AI-mediated diffusion — the essay surface of a five-line research ecosystem. Published CC0, with an intrinsic priority claim via Software Heritage SWHID (see CITATION.cff). Writing, reviewing, translating, and cross-posting are all done in collaboration with Claude Code.

Published Articles

Run npx zenn list:articles for the current list.

AI Agent Design

ReAct Agents

AI Governance Series

Claude Code Series

ECC (Everything Claude Code) Journey

AI Research & Experiments

LLM Engineering & Tools

Multi-Model & Workflow

Build in Public

Cross-Posting

Articles are cross-posted in Japanese (Zenn) and English (Dev.to).

  • articles/ — Japanese originals (Zenn schedules natively via published_at frontmatter)
  • articles-en/ — English translations
  • scripts/devto_crosspost.py — per-article Dev.to cross-poster; schedule <slug> --at "<datetime>" arms a one-shot launchd job that fires at that datetime, posts the article, and self-removes
  • scripts/schedule.json — posted-URL ledger (records each EN article's Dev.to URL; the post time is a --at argument, not stored here)

Tech Stack

  • Zenn CLI — Article management, preview & frontmatter validation (npm run validate = zenn list:articles, also in CI)
  • Python 3.13 + httpx + python-frontmatter — Dev.to cross-posting
  • Claude Code — Writing, reviewing, translating, cross-posting

Claude Code Integration

.claude/
├── agents/                    # Zenn-specific agents (see global agents for editor/essay-reviewer/fact-checker)
│   └── devto-translator.md    # JP→EN translation + Dev.to publishing
│                              # Note: article drafting is NOT delegated to a subagent —
│                              # the orchestrator writes directly per zenn-practical-writing
├── refs/                      # Shared references
│   ├── translation-rules.md
│   └── schedule-schema.md
├── rules/
│   ├── content-integrity.md   # Content Integrity principle
│   └── zenn-writing.md        # Zenn overlay for the global writing-ecosystem skill
└── skills/
    ├── writing-team/           # Orchestrator (PM)
    ├── zenn-practical-writing/ # Default voice for ALL Zenn/Dev.to articles (practical axis, not split by tech/idea)
    ├── zenn-idea-voice/        # Optional personality flavor (cynical humor / Baki), type-independent
    ├── zenn-writer/            # Voice router (path kept for compat; routes everything to practical-writing)
    ├── zenn-format/            # Zenn formatting & frontmatter (canonical)
    ├── publish-article/        # Publishing & cross-post workflow
    ├── schedule-publish/       # Schedule management
    ├── seo-optimizer/          # SEO optimization (title/tag/emoji only)
    ├── ideation/               # Theme exploration & ideation
    ├── series-checker/         # Series consistency checker
    └── quality-gate/           # Unified quality standards

Quick Start

npm install         # Install dependencies
npm run preview     # Local preview
npm run validate    # Validate Zenn frontmatter
npm run new:article # Create new article

Directory Structure

zenn-content/
├── articles/          # Japanese articles
├── articles-en/       # English translations
├── substack/          # Substack essay mirrors (out of Zenn convention scope)
├── books/             # Zenn books
├── images/            # Article images & cover images
├── scripts/
│   ├── devto_crosspost.py    # Per-article Dev.to cross-poster (one-shot launchd)
│   ├── schedule.json         # Per-article Dev.to publish times
│   └── tests/                # pytest (59 tests)
├── .claude/
│   ├── agents/        # Zenn-specific agents (1: devto-translator)
│   ├── skills/        # Project skills (11 + learned/)
│   ├── refs/          # Shared references
│   └── rules/         # Project rules
└── .github/
    └── workflows/     # CI (lint)

Research ecosystem

This essay corpus is one surface of a five-line research ecosystem on agent design and authorship under AI-mediated diffusion. The published, author-voiced essays here are the human-readable essay surface of that ecosystem.

Related archived research lines (DOI):

License

All content in this repository — articles, translations, and tooling — is released under CC0 1.0 Universal (public-domain dedication), per the LICENSE file.

This corpus is published for LLM-mediated reach, so its dominant audience is machine ingestion rather than human reading; attribution is carried by the federated-identifier layer (ORCID, the ecosystem hub, sibling DOIs, and the Software Heritage snapshot in CITATION.cff), not by a license clause. A public-domain dedication therefore minimizes reuse friction for the audience the corpus actually serves.

About

Bilingual (JA/EN) essay corpus on AI agent design, coding-agent workflows, and authorship under AI-mediated diffusion — the essay surface of a five-line research ecosystem. CC0; intrinsic priority claim via Software Heritage SWHID (CITATION.cff).

Topics

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors