Skip to content

Commit c250fc8

Browse files
matthias-reismatthias-reis
committed
feat: initial setup and next js runtime
1 parent 167e66b commit c250fc8

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

55 files changed

+4651
-128
lines changed

‎.context/CONTEXT_REGISTRY.yaml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
sot:
2+
architecture: docs/ARCHITECTURE.md
3+
codebase_overview: docs/CODEBASE_OVERVIEW.md
4+
adr:
5+
index: docs/ADR/README.md
6+
format: docs/ADR/0001-record-format.md
7+
api: docs/API/openapi.yaml
8+
glossary: docs/GLOSSARY.md
9+
agent:
10+
index: .context/INDEX.md
11+
rules: .context/RULES.md
12+
task_template: .context/TASK_TEMPLATE.md
13+
providers:
14+
claude: CLAUDE.md
15+
copilot: .github/copilot-instructions.md
16+
cursor: .cursor/rules/00-start-here.md
17+
continue: .continue/rules/00-start-here.md
18+
windsurf: .windsurfrules

‎.context/INDEX.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Agent Context Index
2+
3+
The Single Source of Truth lives in `docs/`. Use the links below and avoid duplicating their content in provider instruction files.
4+
5+
- [Architecture](../docs/ARCHITECTURE.md)
6+
- [Codebase Overview](../docs/CODEBASE_OVERVIEW.md)
7+
- [ADR Index](../docs/ADR/README.md)
8+
- [ADR Format](../docs/ADR/0001-record-format.md)
9+
- [API Skeleton](../docs/API/openapi.yaml)
10+
- [Glossary](../docs/GLOSSARY.md)
11+
- [Ground Rules](./RULES.md)
12+
13+
## Agent Orchestration
14+
15+
- [Run the Agent Locally](../docs/CONTRIBUTING.md#using-the-cli)

‎.context/RULES.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Ground Rules for Agents
2+
3+
1. **Plan-first**: Share a concise implementation plan and wait for human approval before modifying files unless explicitly told otherwise. Update the plan as milestones complete.
4+
2. **Single Source of Truth**: Do not restate documentation. Link back to the relevant file under `docs/` whenever guidance is needed.
5+
3. **Test-gate**: Run `pnpm lint`, `pnpm typecheck`, and `pnpm test` (or equivalent targeted commands) before requesting review.
6+
4. **ADR discipline**: Architecture-impacting work must add or update an ADR under `docs/ADR/` using the format defined in [`0001-record-format.md`](../docs/ADR/0001-record-format.md).
7+
5. **Context registry**: Keep `.context/CONTEXT_REGISTRY.yaml` updated if new canonical docs are introduced or paths move.
8+
6. **Agent CLI flow**: Always run `pnpm agent <issueNumber>` to progress label states (`ready-for-agent` → `plan-proposed` → `plan-approved` → `in-review` → `ready-to-merge`). The CLI applies `agent:locked` while running; never remove it manually.
9+
7. **Working directory hygiene**: Treat `issues/<n>-<slug>/` as a local workspace. It must be removed from the branch before merge (the CLI handles this; do not commit it to `main`).

‎.context/TASK_TEMPLATE.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Task Template
2+
3+
> Use this scaffold when drafting issues or agent requests. Link to Single Source of Truth docs instead of copying content.
4+
5+
## Summary
6+
- Brief problem statement
7+
- Key links (ADR, architecture, designs)
8+
9+
## Implementation Notes
10+
- Primary entry points (`web/...`)
11+
- Tests or scripts to run (`pnpm lint`, `pnpm test`, etc.)
12+
13+
## Acceptance Criteria
14+
- [ ] Criterion 1
15+
- [ ] Criterion 2
16+
- [ ] Docs / ADRs updated if needed

‎.continue/rules/00-start-here.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# Continue Agent Start
2+
3+
- Ground yourself in the docs: [Architecture](../../docs/ARCHITECTURE.md), [Codebase Overview](../../docs/CODEBASE_OVERVIEW.md), [ADR Index](../../docs/ADR/README.md), [Glossary](../../docs/GLOSSARY.md), [API skeleton](../../docs/API/openapi.yaml).
4+
- Follow the shared guardrails in [.context/RULES.md](../../.context/RULES.md) and consult [.context/CONTEXT_REGISTRY.yaml](../../.context/CONTEXT_REGISTRY.yaml) for canonical paths.

‎.cursor/rules/00-start-here.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# Cursor Agent Start
2+
3+
- Use the canonical docs: [Architecture](../../docs/ARCHITECTURE.md), [Codebase Overview](../../docs/CODEBASE_OVERVIEW.md), [ADR Index](../../docs/ADR/README.md), [ADR Format](../../docs/ADR/0001-record-format.md), [Glossary](../../docs/GLOSSARY.md), and [API skeleton](../../docs/API/openapi.yaml).
4+
- Adhere to [.context/RULES.md](../../.context/RULES.md) and keep metadata aligned with [.context/CONTEXT_REGISTRY.yaml](../../.context/CONTEXT_REGISTRY.yaml).

‎.editorconfig‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
root = true
2+
3+
[*]
4+
charset = utf-8
5+
end_of_line = lf
6+
indent_style = space
7+
indent_size = 2
8+
insert_final_newline = true
9+
trim_trailing_whitespace = true
10+
11+
[*.{md,yml,yaml}]
12+
indent_size = 2
13+
14+
[Makefile]
15+
indent_style = tab

‎.github/CODEOWNERS‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# Default reviewers
2+
* @matthias-reis

‎.github/ISSUE_TEMPLATE/bug.yml‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
name: Bug report
2+
description: Report a defect in the Agents project.
3+
labels: [bug]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
Reference the Single Source of Truth docs: [Architecture](../../docs/ARCHITECTURE.md) and [Codebase Overview](../../docs/CODEBASE_OVERVIEW.md).
9+
- type: textarea
10+
id: summary
11+
attributes:
12+
label: Summary
13+
description: What happened (be descriptive, detailed and don't add assumptions)?
14+
validations:
15+
required: true
16+
- type: textarea
17+
id: steps
18+
attributes:
19+
label: Steps to reproduce
20+
description: Provide clear steps, expected result, and actual result.
21+
validations:
22+
required: true
23+
- type: textarea
24+
id: environment
25+
attributes:
26+
label: Environment details
27+
description: OS, browser, Node version, etc.

‎.github/ISSUE_TEMPLATE/feature.yml‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
name: Feature request
2+
description: Propose a new feature or enhancement.
3+
labels: [enhancement]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
Review the Single Source of Truth docs before filing: [Architecture](../../docs/ARCHITECTURE.md), [Codebase Overview](../../docs/CODEBASE_OVERVIEW.md), and [ADR index](../../docs/ADR/README.md).
9+
- type: textarea
10+
id: summary
11+
attributes:
12+
label: Summary
13+
description: Describe what should be built in as much detail as you can
14+
validations:
15+
required: true
16+
- type: textarea
17+
id: acceptance
18+
attributes:
19+
label: Acceptance criteria
20+
description: Provide checklist items for success.
21+
- type: textarea
22+
id: notes
23+
attributes:
24+
label: Additional context
25+
description: Link to designs, spikes, or prior discussions.

0 commit comments

Comments
 (0)