Publish DevRunbook source

2026-09-03 04:09:17 +02:00
commit cfd2804e27
928 changed files with 161642 additions and 0 deletions
@@ -0,0 +1,41 @@
+# 24 — Primary references
+
+The implementation must re-check current documentation before pinning behavior because Codex and Gitea evolve. This source list was reviewed on 2026-07-27.
+
+## OpenAI Codex
+
+- Codex documentation hub: https://developers.openai.com/codex
+- Best practices: https://developers.openai.com/codex/learn/best-practices
+- Custom instructions with AGENTS.md: https://developers.openai.com/codex/agent-configuration/agents-md
+- Build skills: https://developers.openai.com/codex/build-skills
+- Skills and plugins: https://developers.openai.com/codex/skills-and-plugins
+- Codex CLI: https://developers.openai.com/codex/cli
+- Model Context Protocol: https://developers.openai.com/codex/mcp
+- Codex SDK: https://developers.openai.com/codex/codex-sdk
+- Codex as MCP server / Agents SDK: https://developers.openai.com/codex/mcp-server
+- Codex configuration reference: https://developers.openai.com/codex/config-reference
+
+- Codex changelog: https://developers.openai.com/codex/changelog
+- Customization overview, including Skills + MCP and subagents: https://developers.openai.com/codex/concepts/customization
+- Codex app announcement and worktrees/automations overview: https://openai.com/index/introducing-the-codex-app/
+
+The architecture relies on documented concepts: layered repository instruction discovery through AGENTS.md, reusable Skills containing instructions/resources/scripts, plugins for distribution, MCP connections, subagents and optional future orchestration through Codex CLI/SDK/MCP. The MVP remains copy/export-first so these integrations can evolve independently.
+
+## Gitea
+
+- Current API documentation: https://docs.gitea.com/api/
+- Protected branches: https://docs.gitea.com/usage/access-control/protected-branches
+- Permissions: https://docs.gitea.com/usage/access-control/permissions
+- Pull requests: https://docs.gitea.com/usage/pull-request
+- Configuration reference: https://docs.gitea.com/administration/config-cheat-sheet
+
+The adapter must detect the connected Gitea version and derive supported endpoints from its documented API. It must not assume that every self-hosted installation exposes the same feature set.
+
+
+## Authentication reference
+
+- Better Auth documentation: https://www.better-auth.com/docs
+- Email and password: https://www.better-auth.com/docs/authentication/email-password
+- Next.js integration: https://www.better-auth.com/docs/integrations/next
+
+Better Auth is the preferred implementation default, but product-owned authorization and first-run behavior remain governed by documents 26 and 31.