refactor: move *.repos under repositories/

[xmfcx]

Description

Related discussions:

• 📣 Moving `*.repos` under `repositories/` #6647
• 💬 [Proposal] Improving the Autoware Repository Structure for New Contributors #6587

Changes

To clean up the root directory of autoware repository, this PR moves the .repos files under repositories/ folder.
Also adds src/README.md do improve newcomer experience.

Related Issue:

• Add versioning & repositories info autoware-documentation#759

Related PRs:

• feat: switch from vcstool to vcs2l #6644
• feat: add repositories, versioning and release process pages autoware-documentation#761

How was this PR tested?

[github-actions]

Thank you for contributing to the Autoware project!

🚧 If your pull request is in progress, switch it to draft mode.

Please ensure:

• You've checked our contribution guidelines.
• Your PR follows our pull request guidelines.
• All required CI checks pass before marking the PR ready for review.

[mitsudome-r]

For this PR, I would like to change to post the discussion first and make sure that no one disagrees with the change.
This isn't a big change in terms of code but has relatively large influence to users experience since everyone runs vcs import when they use autoware.

[xmfcx]

Made the announcement post:

• 📣 Moving `*.repos` under `repositories/` #6647

[xmfcx]

As we are adding src/README.md file, src/ is no longer under the root .gitignore.
From now on, src folder will always exists.

The added .gitignore under src/ will ignore everything in it except the .gitignore file itself and the README.md to keep the behavior same.

It required a4b9310 change (adding -p for mkdir src since the directory already exists).

[mitsudome-r]

Since it has modification in .webauto-ci.yaml, I'm also testing in WebAuto Evaluator, but it seems like it is failing. I will check with the evaluator team if it has any assumptions with the path https://evaluation.ci.tier4.jp/evaluation/reports/e1d4be2c-ac80-5688-82b2-7ceafaf738cb/builds/1add11e2-721d-5f30-86e3-39a14124eac5?project_id=awf

[paulsohn]

Adding readme for src/ is fine. While I personally agree with repositories/ directory, I don't feel like we have discussed over this properly. We could have separate PR for this.

[xmfcx]

@paulsohn the new readme file references ../repositories/ folder quite a lot so it made sense to add them together.

This PR title is refactor: move *.repos under repositories/ if anything can be separated out, it is adding the readme.
But since the readme is going to change with this pr too, I found it unnecessary to do these in 2 steps.

• 📣 Moving `*.repos` under `repositories/` #6647

We posted an announcement/discussion post and promoted in discord too.
I think the change will happen after about a week after the announcement with current pace.

Feel free to add your opinions/inputs.

[xmfcx]

Running scenario evaluator for this: https://evaluation.ci.tier4.jp/evaluation/reports/6670d2de-d8ca-5cdb-9c97-eaee32dae213?project_id=awf

I did a clean build.

[xmfcx]

https://evaluation.ci.tier4.jp/evaluation/reports/6670d2de-d8ca-5cdb-9c97-eaee32dae213/builds/36268484-db74-5a48-bf47-320010f5a8bc?project_id=awf this is failing.

It pulls everything fine but attempts to upload a non-existent file.

$ vcs export --exact -n src > /var/lib/webauto-ci/RrG5vu/vcs/.tmp-vcs.repos.exact
$ yq eval-all '. as $item ireduce ({}; . * $item)' repositories/autoware.repos repositories/simulator.repos /var/lib/webauto-ci/RrG5vu/vcs/.tmp-vcs.repos.exact > /var/lib/webauto-ci/RrG5vu/vcs/vcs.repos.exact
[2025-12-23T09:04:21.424Z] (Fetch source) Uploading the exactly repositories file...
/usr/bin/bash: line 1: /var/lib/webauto-ci/RrG5vu/asset/vcstool/repos/repositories/autoware.repos: No such file or directory
[2025-12-23T09:04:21.545Z] (Fetch source) Error occurs in the phase
[2025-12-23T09:04:21.648Z] Build failed.

I don't see anything wrong in the

autoware/.webauto-ci.yaml

Lines 15 to 18 in 407dcc2

	vcstool:
	repositories_files:
	- repositories/autoware.repos
	- repositories/simulator.repos

Could someone from the web.auto team help?

Here are the uploaded files from the build:

• 🔗 Repositories File
• 🔗 Build Log

So it was able to upload the combined frozen repos file.

But this line afterwards failed:

/usr/bin/bash: line 1: /var/lib/webauto-ci/RrG5vu/asset/vcstool/repos/repositories/autoware.repos: No such file or directory

Not sure what it is doing.

[xmfcx]

web.auto team fixed the issue.

https://evaluation.ci.tier4.jp/evaluation/reports/c89e57ed-d598-5b65-9892-148a6270ea9f?project_id=awf

Successful ✅

@mitsudome-r could you review?