Open Source on Xianpeng Shen

mkdocs-ng v1.8.0 Released — Upstream Issues Fixed, Builds ~14% Faster

xianpeng.shen@gmail.com (Xianpeng Shen) — Thu, 13 Aug 2026 00:00:00 +0000

mkdocs-ng v1.8.0 is out, the first feature release since the fork. Built-in themes no longer copy the entire highlight.js distribution, making clean builds ~14% faster with ~440 fewer files per site. Search finally finds programming keywords like while and if. The next release will bring incremental builds to mkdocs serve.

Open Delivery Spec update: AI code shouldn't just pass the gate — it should leave evidence

xianpeng.shen@gmail.com (Xianpeng Shen) — Sat, 08 Aug 2026 00:00:00 +0000

Three weeks ago I introduced Open Delivery Spec (ODS), my side project for governing AI-assisted code in CI. Since then the CLI has shipped 5 releases and grown two new pillars: deterministic merge-confidence signals that answer “is this AI PR safe to merge?”, and an auto-generated, standards-based evidence document on every PR. As always, this post sticks to what actually ships — no hype.

Open Delivery Spec—I Built a CI Quality Gate for AI-Generated Code

xianpeng.shen@gmail.com (Xianpeng Shen) — Fri, 17 Jul 2026 00:00:00 +0000

Over the past few months, I’ve been working on an open-source organization called Open Delivery Spec (ODS) in my spare time. The initiative stemmed from the increasing volume of AI-generated code and the lack of reliable governance mechanisms within teams. This article records the thought process, progress, and boundaries based on the project’s real-world status, without any exaggeration.

Jenkinsfile Lint 1.5.0 Released— Standalone Mode Without a Jenkins Server

xianpeng.shen@gmail.com (Xianpeng Shen) — Sun, 12 Jul 2026 00:00:00 +0000

Previously, jenkinsfilelint required connecting to an available Jenkins server for syntax validation. Now, v1.5.0 introduces a new standalone mode. With just Docker, you can launch a minimal Jenkins environment locally to validate Jenkinsfile syntax. This article details the implementation idea and usage of this mode.

Originally Just Wanted to Propose a Doc PR, Ended Up Moving the Project to the Official Jenkins Organization

xianpeng.shen@gmail.com (Xianpeng Shen) — Tue, 09 Jun 2026 00:00:00 +0000

I wrote a small tool to validate Jenkinsfiles, initially just wanting it to appear in Jenkins’ official list of development tools. However, a Jenkins maintainer suggested: why not just transfer the project directly into the jenkinsci organization? This article records the complete process from PR to transfer to an official blog post, including an interesting pitfall encountered along the way.

Conventional Branch Now Has Its Own Domain—conventionalbranch.org

xianpeng.shen@gmail.com (Xianpeng Shen) — Sun, 31 May 2026 00:00:00 +0000

The Conventional Branch project website has officially migrated from conventional-branch.github.io to conventionalbranch.org. From last year’s user suggestion to this year’s final implementation, let’s talk about the hesitations, pitfalls, and reflections behind the domain migration.

cpp-linter-hooks: The Most Complete pre-commit Solution for C/C++ Projects

xianpeng.shen@gmail.com (Xianpeng Shen) — Wed, 20 May 2026 00:00:00 +0000

C/C++ tooling in the pre-commit ecosystem has long been limited. cpp-linter-hooks is currently the only pre-commit hook that supports both clang-format and clang-tidy, with built-in compilation database auto-detection, version pinning, and auto-fix capabilities.

Conventional Branch Official Skill Is Here—Install with One Command

xianpeng.shen@gmail.com (Xianpeng Shen) — Sun, 17 May 2026 00:00:00 +0000

A user opened an issue hoping Conventional Branch could provide an official Agent Skill, which I thought was a very reasonable request. I implemented it the same day, and now it can be downloaded and used with a single npx skills add command. Coincidentally, the project also surpassed 100 Stars this week, so I’ll talk about that too.

mkdocs-ng Maintenance Progress — v1.7.x Fix Summary and Next Steps

xianpeng.shen@gmail.com (Xianpeng Shen) — Thu, 14 May 2026 00:00:00 +0000

Since taking over mkdocs-ng maintenance, four versions have been released, over a dozen bugs fixed, and the mergedeep dependency removed. The upcoming v1.8.0 will be a feature release, planning to drop support for older Python versions, remove CDN dependencies from built-in themes, and provide a stable Python API.

RepoKeeper After a hundred commits in ten days, it can now develop itself

xianpeng.shen@gmail.com (Xianpeng Shen) — Sun, 10 May 2026 00:00:00 +0000

Over the past ten days, I’ve made over a hundred commits to RepoKeeper, evolving it from a proof-of-concept to v1.2.0. It now boasts six modules, two backends, supports DeepSeek/OpenAI/Claude, and can even develop itself—this post will explain what it has evolved into.

Counter-intuitive Designs in the pi project — From AGENTS.md to "Just Close Your PR First"

xianpeng.shen@gmail.com (Xianpeng Shen) — Sun, 26 Apr 2026 00:00:00 +0000

After reading Mario Zechner’s “I’ve sold out” and then reviewing AGENTS.md and CONTRIBUTING.md in the pi repository, I found that this project differs from common open-source collaboration methods in many ways. New contributors’ issues and PRs are closed by default, no reviews on weekends, and don’t submit PRs if you don’t understand the code. It seems tough, but behind it is a serious attempt to address a problem: how open-source projects can avoid being bogged down by low-quality contributions in the AI era.

Four Years of Open Source —— Three Unexpected Rewards

xianpeng.shen@gmail.com (Xianpeng Shen) — Fri, 22 Aug 2025 00:00:00 +0000

Some say open source is useless, yielding neither profit nor time savings. But through four years of dedication, I’ve discovered three unexpected rewards: increased visibility for my work, connections with exceptional people and projects, and the accumulation of long-term value. These rewards are applicable to every developer.