Skip to content

Commit 57b1e21

Browse files
webdevbyjosswebdevbyjoss
committed
Prepare awesome list v1.0
1 parent 41a7fa7 commit 57b1e21

8 files changed

Lines changed: 678 additions & 92 deletions

File tree

‎.github/ISSUE_TEMPLATE/broken-link.yml‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
name: Report a broken or outdated link
2+
description: Flag a dead, redirected, renamed, archived, or misleading entry.
3+
title: "[Link]: "
4+
labels:
5+
- maintenance
6+
body:
7+
- type: input
8+
id: entry
9+
attributes:
10+
label: Entry
11+
description: Name of the affected roadmap or Toolbox entry.
12+
validations:
13+
required: true
14+
- type: input
15+
id: url
16+
attributes:
17+
label: Current URL
18+
validations:
19+
required: true
20+
- type: dropdown
21+
id: problem
22+
attributes:
23+
label: Problem
24+
options:
25+
- Returns an error
26+
- Redirects to a different project
27+
- Project was renamed or moved
28+
- Project is archived or unmaintained
29+
- Description is outdated or misleading
30+
validations:
31+
required: true
32+
- type: input
33+
id: replacement
34+
attributes:
35+
label: Suggested replacement
36+
description: Optional canonical replacement URL.
37+
- type: textarea
38+
id: details
39+
attributes:
40+
label: Details
41+
description: Include any useful response code, redirect target, or maintenance evidence.

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: Security vulnerability
4+
url: https://github.com/Transcenda/awesome-agentic-coding/security/advisories/new
5+
about: Report security concerns privately.

‎.github/ISSUE_TEMPLATE/resource-suggestion.yml‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
name: Suggest a resource
2+
description: Propose a roadmap use case or Toolbox entry.
3+
title: "[Suggestion]: "
4+
labels:
5+
- suggestion
6+
body:
7+
- type: dropdown
8+
id: contribution_type
9+
attributes:
10+
label: Suggestion type
11+
options:
12+
- Toolbox entry
13+
- Roadmap use case
14+
- Existing entry update
15+
validations:
16+
required: true
17+
- type: input
18+
id: name
19+
attributes:
20+
label: Name
21+
description: Name of the tool, resource, or use case.
22+
validations:
23+
required: true
24+
- type: input
25+
id: url
26+
attributes:
27+
label: URL
28+
description: Use the canonical project or documentation URL.
29+
validations:
30+
required: true
31+
- type: textarea
32+
id: value
33+
attributes:
34+
label: Why it belongs
35+
description: Explain the concrete engineering workflow it supports and how it differs from existing entries.
36+
validations:
37+
required: true
38+
- type: input
39+
id: roadmap_items
40+
attributes:
41+
label: Related roadmap items
42+
description: List the item numbers this suggestion supports.
43+
- type: textarea
44+
id: maintenance
45+
attributes:
46+
label: Maintenance and adoption
47+
description: Include evidence of active maintenance, adoption, or another strong reason for inclusion.
48+
validations:
49+
required: true
50+
- type: checkboxes
51+
id: checks
52+
attributes:
53+
label: Submission checks
54+
options:
55+
- label: I searched the roadmap and Toolbox for duplicates.
56+
required: true
57+
- label: I verified that the URL resolves.
58+
required: true
59+
- label: I am disclosing any affiliation with this project below.
60+
required: true
61+
- type: textarea
62+
id: affiliation
63+
attributes:
64+
label: Affiliation
65+
description: State your relationship to the project, or write "None."
66+
validations:
67+
required: true

‎.github/workflows/link-check.yml‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
name: Check links
2+
3+
on:
4+
pull_request:
5+
paths:
6+
- "**/*.md"
7+
- ".github/workflows/link-check.yml"
8+
push:
9+
branches:
10+
- main
11+
paths:
12+
- "**/*.md"
13+
- ".github/workflows/link-check.yml"
14+
schedule:
15+
- cron: "17 6 * * 1"
16+
workflow_dispatch:
17+
18+
permissions:
19+
contents: read
20+
21+
jobs:
22+
links:
23+
runs-on: ubuntu-latest
24+
steps:
25+
- name: Check out repository
26+
uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
27+
28+
- name: Check Markdown links
29+
uses: lycheeverse/lychee-action@6da1d14f3a43098a294b7696d93d938aa8d20fc0
30+
with:
31+
args: >-
32+
--no-progress
33+
--accept 200,429
34+
"**/*.md"
35+
fail: true

‎CONTRIBUTING.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Contributing
2+
3+
Thanks for helping keep Awesome Agentic Coding practical and current.
4+
5+
## What Belongs Here
6+
7+
Roadmap additions should describe a concrete engineering use case that deepens agentic coding practice. Each roadmap item needs:
8+
9+
- A concise explanation of why the technique matters.
10+
- An **In practice** prompt that readers can apply to their own work.
11+
- A clear distinction from existing roadmap items.
12+
13+
Toolbox additions should:
14+
15+
- Support one or more roadmap items.
16+
- Be actively maintained and documented.
17+
- Have demonstrated adoption or a strong reason for inclusion.
18+
- Add meaningful coverage rather than duplicate an existing tool.
19+
20+
Popularity signals such as GitHub stars may inform curation, but they are not sufficient on their own. Commercial tools without public repositories may be included when they are widely used and directly relevant.
21+
22+
## Before Opening a Pull Request
23+
24+
1. Search the roadmap and Toolbox for duplicates.
25+
2. Confirm every new link resolves.
26+
3. Use the existing one-line entry format: `[Name](URL) — Description.`
27+
4. Keep descriptions factual and avoid marketing language.
28+
5. Add entries to the most specific existing category.
29+
6. Run `npx awesome-lint`.
30+
31+
For a new roadmap item, explain why the use case is not already covered. For a Toolbox entry, name the roadmap item or items it supports.
32+
33+
## Pull Requests
34+
35+
Keep pull requests focused. In the description, include:
36+
37+
- What you are adding or changing.
38+
- Why it belongs in the roadmap or Toolbox.
39+
- Evidence that the resource is maintained and useful.
40+
41+
By contributing, you agree that your contribution is licensed under the [Creative Commons Attribution 4.0 International License](LICENSE).
42+
43+
## Reporting Problems
44+
45+
Use the issue forms to suggest a resource or report a broken or outdated link. Security vulnerabilities should be reported privately through GitHub's security advisory feature rather than a public issue.

0 commit comments

Comments
 (0)