Skip to content
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
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,12 @@ ahoy test-bdd # Run Behat tests
ahoy test-bdd -- --tags=@tagname # Run Behat tests with specific tag
```

## Before Starting Any Task

1. **Check cached docs first.** Before investigating any topic, check `.data/ai-artifacts/docs-[topic].md` for existing cached documentation. Do not search the codebase or fetch from the web if a cached doc already exists.
2. **Check project docs.** Before making implementation decisions, check the relevant file in `docs/` for project-specific conventions.
3. **Fetch and cache if missing.** If no cached doc exists for the topic, fetch from https://www.vortextemplate.com/docs and save to `.data/ai-artifacts/docs-[topic].md` (see [Documentation](#documentation) for format).

## Critical Rules

- **Never modify** `scripts/vortex/` - use `scripts/custom/` for your scripts
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
@@ -52,8 +52,8 @@
@@ -58,8 +58,8 @@

## Key Directories

Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
@@ -52,8 +52,8 @@
@@ -58,8 +58,8 @@

## Key Directories

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@
-ahoy test-bdd -- --tags=@tagname # Run Behat tests with specific tag
```

## Critical Rules
## Before Starting Any Task
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@
-ahoy test-bdd -- --tags=@tagname # Run Behat tests with specific tag
```

## Critical Rules
## Before Starting Any Task
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@
-ahoy test-bdd -- --tags=@tagname # Run Behat tests with specific tag
```

## Critical Rules
## Before Starting Any Task
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@
-ahoy test-bdd -- --tags=@tagname # Run Behat tests with specific tag
```

## Critical Rules
## Before Starting Any Task
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@
-ahoy test-bdd -- --tags=@tagname # Run Behat tests with specific tag
```

## Critical Rules
## Before Starting Any Task
6 changes: 6 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,12 @@ ahoy test-bdd # Run Behat tests
ahoy test-bdd -- --tags=@tagname # Run Behat tests with specific tag
```

## Before Starting Any Task

1. **Check cached docs first.** Before investigating any topic, check `.data/ai-artifacts/docs-[topic].md` for existing cached documentation. Do not search the codebase or fetch from the web if a cached doc already exists.
2. **Check project docs.** Before making implementation decisions, check the relevant file in `docs/` for project-specific conventions.
3. **Fetch and cache if missing.** If no cached doc exists for the topic, fetch from https://www.vortextemplate.com/docs and save to `.data/ai-artifacts/docs-[topic].md` (see [Documentation](#documentation) for format).

## Critical Rules

- **Never modify** `scripts/vortex/` - use `scripts/custom/` for your scripts
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Clarify the scripts/vortex/ rule for the template repo.

In the template repository, modifying scripts/vortex/ is expected for maintenance. The current blanket prohibition is misleading here. Consider scoping it to downstream projects instead.

✏️ Suggested wording
-- **Never modify** `scripts/vortex/` - use `scripts/custom/` for your scripts
+- **Downstream projects:** do not modify `scripts/vortex/`; use `scripts/custom/` instead.  
+- **Template repo (this repo):** updates to `scripts/vortex/` are allowed for template maintenance.

Based on learnings: “The drevops/vortex repository is the template source itself. When reviewing PRs in drevops/vortex, modifications to scripts/vortex/ are expected and correct…”

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@AGENTS.md` at line 65, Update the rule that currently reads "Never modify
`scripts/vortex/` - use `scripts/custom/` for your scripts" to clarify scope:
state that downstream projects should never modify `scripts/vortex/` and must
use `scripts/custom/`, but for the template repository (e.g., drevops/vortex)
modifications to `scripts/vortex/` are expected and allowed for maintenance;
reference the `scripts/vortex/` and `scripts/custom/` paths and explicitly call
out "template repo (drevops/vortex)" so reviewers understand the exception.

Expand Down