The files are intentionally universal. They do not assume Electron, React, Node, or any single stack. Node examples are included only because many Codex projects use them.

Agent Goal

Give every repository the same predictable anchor points:

.
|-- AGENTS.md
|-- .codex/
|   `-- project.md
|-- .gitea/
|   `-- workflows/
|       `-- build.yml
|-- docs/
|   |-- release-checklist.md
|   `-- security-review.md
|-- blueprint.md
|-- blueprint.json
|-- README.md
|-- SECURITY.md
|-- CHANGELOG.md
`-- .gitignore

Use only the files that fit the project. For a tiny script repo, AGENTS.md, README.md, SECURITY.md, and CHANGELOG.md may be enough. For an app or releasable tool, add the runner, release checklist, and README blueprint workflow.

Copy Map

Template	Destination
`files/AGENTS.md`	`AGENTS.md`
`files/project.md`	`.codex/project.md`
`files/build-gitea.yml`	`.gitea/workflows/build.yml`
`files/release-checklist.md`	`docs/release-checklist.md`
`files/security-review.md`	`docs/security-review.md`
`files/blueprint.md`	`blueprint.md`
`files/blueprint.json`	`blueprint.json`
`files/SECURITY.md`	`SECURITY.md`
`files/CHANGELOG.md`	`CHANGELOG.md`

Start with agent-quickstart.md when using this kit through Codex.

manifest.json contains the same copy map in a machine-readable format for agents.

Placeholders

Replace these after copying:

PROJECT_NAME
PROJECT_DESCRIPTION
REPOSITORY_OWNER
REPOSITORY_NAME
PACKAGE_NAME
ARTIFACT_NAME
ARTIFACT_OUTPUT_DIRECTORY
AUTHOR_NAME
PROJECT_STACK
DOWNLOAD_URL
BUILD_COMMAND
TEST_COMMAND
LINT_COMMAND
AUDIT_COMMAND

If a placeholder does not apply, remove it instead of inventing fake information.

Gitea API Token

When working with private repositories on git.wilkensxl.de, Codex agents may find a local GITEA_TOKEN environment variable on the machine.

Use GITEA_TOKEN only for read-oriented Gitea API checks unless the user explicitly asks for a write action. Typical safe checks include repository metadata, workflow run status, and package-read visibility. Never print the token, commit it, or copy it into workflow files.

Example status endpoint:

GET https://git.wilkensxl.de/api/v1/repos/REPOSITORY_OWNER/REPOSITORY_NAME/actions/runs
Authorization: token GITEA_TOKEN

REGISTRY_TOKEN is still the intended secret name for CI package publishing inside .gitea/workflows/build.yml.

Gitea Workflow Loop

After pushing commits that add or change a Gitea workflow, Codex agents must check the resulting workflow run before finishing. If the run is still pending or in progress, report that status and keep checking when the user expects the agent loop to continue. If the run fails, inspect the failing job/logs, fix the issue when it is in scope, commit, push, and check the next run.

Agent Prompt For A New Repo

Use templates/codex-project/new-repository.md.
Create the Codex repository baseline for this project.
Adapt placeholders to this repository.
Keep the existing stack choices minimal and do not add unnecessary frameworks.
Do not create a release.

Agent Prompt For An Existing Repo

Use templates/codex-project/existing-project.md.
Retrofit the Codex repository baseline.
Preserve existing project style and README knowledge.
Add only the files and commands that fit this repo.
Do not restructure application code unless required.
Do not create a release.