You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/copilot-instructions.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,4 +20,4 @@ If this file conflicts with `AGENTS.md`, prefer `AGENTS.md`.
20
20
21
21
When the local environment supports it, use the build and validation commands documented in `AGENTS.md`.
22
22
23
-
GitHub Pages production is configured to deploy from `main`. CircleCI handles build/htmlproofer validation. GitHub Actions handles the version/tag release flow. Do not change CI, deployment, or versioning without maintainer approval.
23
+
GitHub Pages production is configured to deploy from `main`. GitHub Actions handles conference data validation, the Jekyll build, htmlproofer, and the version/tag release flow. Do not change CI, deployment, or versioning without maintainer approval.
Copy file name to clipboardExpand all lines: AGENTS.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,18 +17,18 @@ TestingConferences.org is a community-maintained Jekyll site for software testin
17
17
18
18
## CI And Deployment
19
19
20
-
This repository currently uses GitHub Pages, GitHub Actions, and CircleCI.
20
+
This repository uses GitHub Pages and GitHub Actions.
21
21
22
22
- GitHub Pages production is configured to deploy from the `main` branch.
23
-
- GitHub Actions is used for the site release flow that appends/increments the site version number and creates tags.
24
-
-CircleCI is responsible for build and htmlproofer validation.
23
+
- GitHub Actions validates pull requests and pushes to `main` by running the conference data validator, Jekyll build, and htmlproofer.
24
+
-GitHub Actions also runs the site release flow that appends/increments the site version number and creates tags.
25
25
-`.github/workflows/deploy.yml` currently includes Pages artifact upload/deploy steps even though repository settings deploy Pages from `main`; treat changes to this workflow as deployment/versioning work that needs maintainer approval.
Copy file name to clipboardExpand all lines: Agent_Readiness.md
+9-17Lines changed: 9 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,30 +10,28 @@ The main remaining weakness is that most guardrails are still documented in pros
10
10
11
11
**AI-assisted edits:** 8/10
12
12
13
-
**Autonomous agent workflows:**6/10
13
+
**Autonomous agent workflows:**7/10
14
14
15
-
The project has a simple Jekyll structure, clear conference data files, a root agent instruction file, a conference data validator, documented CI/deploy ownership, and useful contributor documentation. Autonomous workflows still need CI integration for the validator and better documentation for maintenance scripts.
15
+
The project has a simple Jekyll structure, clear conference data files, a root agent instruction file, a conference data validator enforced in CI, documented CI/deploy ownership, and useful contributor documentation. Autonomous workflows still need better documentation for maintenance scripts and clearer formatting automation.
16
16
17
17
## What Already Helps Agents
18
18
19
19
-`AGENTS.md` is now the strongest agent-facing file. It explains the project map, safe edit zones, conference data rules, source-of-truth policy, local commands, validation checklist, common tasks, and changes that need maintainer approval.
20
20
-`README.md` explains the project, `_data` files, ordering rules, required conference fields, eligibility, and deployment versioning.
21
-
-`README.md` now documents the current deployment split: GitHub Pages deploys from `main`, GitHub Actions handles the version/tag release flow, and CircleCI handles build/htmlproofer validation.
21
+
-`README.md` now documents the current deployment model: GitHub Pages deploys from `main`, while GitHub Actions handles conference data validation, the Jekyll build, htmlproofer, and the version/tag release flow.
22
22
-`CONTRIBUTING.md` gives contributor workflows for adding conferences, reporting issues, and page/navigation changes.
23
23
-`SETUP.md` provides Docker setup instructions.
24
24
-`.github/copilot-instructions.md` now delegates repo-wide policy to `AGENTS.md` and keeps only Copilot-specific reminders.
25
25
-`.github/pull_request_template.md` provides a checklist for conference PRs.
26
26
-`CODEOWNERS` assigns review ownership.
27
27
-`Gemfile`, `docker-compose.yml`, and `devops/setup.sh` make it clear this is a Ruby/Jekyll/GitHub Pages site.
28
28
-`tools/validate_data.rb` provides a machine-checkable conference data validator for the YAML data files.
29
-
-`.circleci/config.yml`documents the build and htmlproofer validation commands used by CircleCI.
29
+
-`.github/workflows/ci.yml`validates pull requests and pushes to `main` with the conference data validator, Jekyll build, and htmlproofer.
30
30
-`ROADMAP.md` now tracks the remaining agent-readiness work, quality metrics work, validation work, and developer-experience improvements.
31
31
-`tools/` contains maintenance scripts, especially `tools/identify_updates.rb`, though these scripts are not yet documented.
32
32
33
33
## Main Gaps
34
34
35
-
- The conference data validator exists, but it is not yet wired into CI.
36
-
- There is no obvious pull request validation workflow owned by GitHub Actions. CircleCI performs build validation, but the validator is not yet part of that validation.
37
35
- The CI/deploy story still has one confusing implementation detail: `.github/workflows/deploy.yml` includes Pages artifact upload/deploy steps even though repository settings deploy Pages from the `main` branch.
38
36
- Formatting guidance is partial. The repo has `.prettierrc`, but there is no `package.json`, documented Prettier command, ESLint config, `.editorconfig`, or Ruby lint config.
39
37
- Issue templates now exist with site-version fields, but there is not yet any automation that aggregates issues by version.
@@ -47,19 +45,13 @@ The project has a simple Jekyll structure, clear conference data files, a root a
47
45
1. Simplify or rename `.github/workflows/deploy.yml` so the workflow implementation matches the confirmed deployment model.
48
46
- Keep the version increment and tag behavior if still wanted.
49
47
- Remove or explain the Pages artifact/deploy steps if production deploys from `main`.
50
-
2. Add the conference data validator to PR validation.
51
-
-`ruby tools/validate_data.rb`.
52
-
3. Add or document PR validation expectations.
53
-
- CircleCI build.
54
-
- Jekyll build.
55
-
- htmlproofer.
56
-
4. Document the `tools/` scripts or remove/replace the ones that are no longer part of the workflow.
57
-
5. Add documented formatting commands for Prettier, and either add ESLint intentionally or stop referring to ESLint as expected tooling.
58
-
6. Add automation or reporting that connects issue-template site-version data to the quality ledger.
59
-
7. Make local verification docs clearer for both Docker and non-Docker setups.
48
+
2. Document the `tools/` scripts or remove/replace the ones that are no longer part of the workflow.
49
+
3. Add documented formatting commands for Prettier, and either add ESLint intentionally or stop referring to ESLint as expected tooling.
50
+
4. Add automation or reporting that connects issue-template site-version data to the quality ledger.
51
+
5. Make local verification docs clearer for both Docker and non-Docker setups.
60
52
61
53
## Current Bottom Line
62
54
63
55
The repo is now ready for supervised AI agents to make narrow, reviewable changes such as adding, updating, moving, or closing conference entries.
64
56
65
-
It is not yet ready for broad autonomous maintenance because the most important rules are still human-readable instructions rather than executable checks.
57
+
It is not yet ready for broad autonomous maintenance because several maintenance workflows and formatting expectations remain human-readable guidance rather than executable checks.
0 commit comments