Skip to content
This repository was archived by the owner on Aug 12, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .copier-answers.harness.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Copier answers file; changes here are overwritten on `copier update` — modify the template instead.
_commit: v0.4.1
_src_path: gh:swanchristmas/copier-coding-harness
_src_path: gh:agentic-tend/copier-coding-harness
description: A Copier template that generates a language-independent contract-first
coding harness.
include_notes_local: false
Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ This repository is a [Copier](https://copier.readthedocs.io/) template that gene
<summary><strong>Why this harness?</strong></summary>

- **Contract before code.** Establish a reviewable source of truth before implementation.
- [**Clarify contracts.**](https://github.com/swanchristmas/skills/tree/main/clarifying-contracts): The companion skills layer operationalizes the [development workflow](decisions/development.md) with a meta-level procedure that resolves user-owned uncertainty before execution.
- [**Clarify contracts.**](https://github.com/agentic-tend/skills/tree/main/clarifying-contracts): The companion skills layer operationalizes the [development workflow](decisions/development.md) with a meta-level procedure that resolves user-owned uncertainty before execution.
- [**Test before implementation.**](decisions/testing-policy.md): Verifiability over readability[^shinaoka] moves trust from line-by-line reading to tests and external oracles; readable intent remains in the contract.
- **Make the ontology explicit.** Name the domain entities, relationships, responsibilities, and reasons before implementation mechanics. ("Why" constrains future "how"; "how" alone only describes today's code.)
- **Give the agent a map, not the whole repository.** Self-describing files and linked maps of content keep concerns decoupled, help humans navigate, and spend limited context tokens only on the contracts and decisions relevant to the current task.
Expand All @@ -25,7 +25,7 @@ This repository is a [Copier](https://copier.readthedocs.io/) template that gene
Generate a fresh project from the harness (swap `gh:…` for a local path to render from a clone):

```bash
uvx copier copy gh:swanchristmas/copier-coding-harness path/to/new-project
uvx copier copy gh:agentic-tend/copier-coding-harness path/to/new-project
```

Copier asks for `project_name`, `description`, `role_bindings`, and `include_notes_local`; everything else is fixed.
Expand All @@ -35,7 +35,7 @@ Copier asks for `project_name`, `description`, `role_bindings`, and `include_not
The harness can be layered onto a project that already exists, including one generated from another Copier template. Run from the project root and give the harness its own answers file (`.copier-answers.harness.yml`) so it never touches the host's own `.copier-answers.yml`:

```bash
uvx copier copy -a .copier-answers.harness.yml gh:swanchristmas/copier-coding-harness .
uvx copier copy -a .copier-answers.harness.yml gh:agentic-tend/copier-coding-harness .
```

`project_name` and `description` have no defaults, so this prompts for them interactively. To run unattended, supply them with `-d` (`description` must end with a period, per the `copier.yml` validator):
Expand All @@ -44,7 +44,7 @@ uvx copier copy -a .copier-answers.harness.yml gh:swanchristmas/copier-coding-ha
uvx copier copy -a .copier-answers.harness.yml \
-d project_name=my-project \
-d "description=My project does X." \
gh:swanchristmas/copier-coding-harness .
gh:agentic-tend/copier-coding-harness .
```

> [!WARNING]
Expand Down Expand Up @@ -80,7 +80,7 @@ uv run --with copier --with pytest --with pyyaml -- pytest tests/

- [Roadmap](docs/roadmap.md) tracks incremental milestones and their status.
- [AGENTS.md](AGENTS.md) is the executable contract for coding agents.
- The companion [skills layer](https://github.com/swanchristmas/skills) packages reusable agent skills outside this repository's rules.
- The companion [skills layer](https://github.com/agentic-tend/skills) packages reusable agent skills outside this repository's rules.
- The [development workflow](decisions/development.md) defines roles, stages, and uncertainty routing.
- The [delivery policy](decisions/delivery.md) defines completion, validation, and repository-action boundaries.
- The [implementation policy](decisions/implementation-policy.md) defines how topology may evolve without unnecessary expansion.
Expand Down
2 changes: 1 addition & 1 deletion docs/agentic-tooling.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ The harness supplies structure rather than a fixed catalog of customizations.
Developers add or remove rules, skills, and hooks according to both the developer's workflow and the system being developed.

This repository currently provides the rules framework and its documented design philosophy.
The companion [skills collection](https://github.com/swanchristmas/skills) owns reusable on-demand workflows.
The companion [skills collection](https://github.com/agentic-tend/skills) owns reusable on-demand workflows.
Hooks are an unshipped extension point that may later justify a separate companion repository; no hook interface or distribution contract is defined yet.

## Evaluation
Expand Down
2 changes: 1 addition & 1 deletion docs/user-level-agent-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Keep personal defaults that should apply across unrelated repositories in user-l

A skill packages a reusable task workflow in one `SKILL.md`; there is no aggregate `SKILLS.md`. Repository-specific skills belong in `.agents/skills/`, while reusable user-level skills belong in `~/.agents/skills/`.

The companion [skills collection](https://github.com/swanchristmas/skills) owns reusable procedures outside this repository's rules layer. Its meta-level [Clarifying Contracts](https://github.com/swanchristmas/skills/tree/main/clarifying-contracts) skill operationalizes the development workflow by resolving user-owned semantic uncertainty before execution.
The companion [skills collection](https://github.com/agentic-tend/skills) owns reusable procedures outside this repository's rules layer. Its meta-level [Clarifying Contracts](https://github.com/agentic-tend/skills/tree/main/clarifying-contracts) skill operationalizes the development workflow by resolving user-owned semantic uncertainty before execution.

Keeping reusable skills in the user-level collection gives Codex one canonical deployment across repositories and avoids duplicate repository and user-scope copies.

Expand Down
Loading