Add Analysis by sbarkalov · Pull Request #4350 · sindresorhus/awesome · GitHub
Skip to content

Add Analysis - #4350

Open
sbarkalov wants to merge 1 commit into
sindresorhus:mainfrom
sbarkalov:add-analysis
Open

sbarkalov wants to merge 1 commit into
sindresorhus:mainfrom
sbarkalov:add-analysis

Conversation

@sbarkalov

@sbarkalov sbarkalov commented Jul 23, 2026 •

Copy link
Copy Markdown

https://github.com/sbarkalov/awesome-analysis#readme

Business, systems, and product analysis — turning stakeholder needs into clear, verifiable requirements, designs, and product decisions.

By submitting this pull request I confirm I've read and complied with the below requirements 🖖

Requirements for your pull request

  • Fully AI-generated pull requests are not accepted.
  • Don't open a Draft / WIP pull request while you work on the guidelines.
  • Don't waste my time. Do a good job, adhere to all the guidelines, and be responsive.
  • You have to review at least 4 other open pull requests.
    Reviewed:
  • You have read and understood the instructions for creating a list.
  • This pull request has a title in the format Add Name of List → Add Analysis.
  • Your entry includes a short, objective description of the theme, uppercase first char, ends in a dot.
  • Your entry is added at the bottom of the appropriate category.
  • The title is title-cased and the URL ends in #readme.
  • No blockchain-related lists.
  • The suggested Awesome list complies with the below requirements.

Requirements for your Awesome list

  • Has been around for at least 30 days.
  • Is not AI-generated.
  • Ran awesome-lint and fixed the reported issues.
  • The default branch is named main, not master.
  • Includes a succinct description of the theme at the top of the readme.
  • It's the result of hard work and the best I could possibly produce.
  • The repo name is in lowercase slug format: awesome-analysis.
  • The heading title is in title case: # Awesome Analysis.
  • Non-generated Markdown file in a GitHub repo.
  • The repo has awesome-list & awesome as GitHub topics.
  • Not a duplicate.
  • Only has awesome items.
  • Does not contain unmaintained, archived, deprecated, or undocumented items.
  • Includes a project logo/illustration whenever possible.
  • Entries have a description.
  • Includes the Awesome badge.
  • Has a Table of Contents section named Contents.
  • Has an appropriate license (CC0-1.0).
  • Has contribution guidelines (contributing.md).
  • All non-important but necessary content is grouped in a Footnotes section.
  • Has consistent formatting and proper spelling/grammar.
  • Does not use hard-wrapping.
  • Does not include a CI badge.
  • Does not include an Inspired by awesome-foo link at the top of the readme.

@sbarkalov

Copy link
Copy Markdown
Author

@lesnik512

Copy link
Copy Markdown

Useful topic. One clear guideline issue: your top description is > A curated list of awesome tools, frameworks, standards, and resources for business, systems, and product analysis. The guidelines flag this exact "A curated list of awesome..." pattern as the wrong one - the top description should describe the subject, not the list itself. The paragraph right below it ("Business, systems, and product analysis turn stakeholder needs into...") is exactly the kind of subject description they want, so I'd move that into the blockquote and drop the "curated list of awesome" line.

The "📖 For comfortable reading: Web version" link also points to a GitHub Pages render of this same readme - the same content twice. I'd remove it or move it to a Footnotes section.

Smaller thing: "Analysis" on its own is a fairly broad entry name for a general list; something like "Business Analysis" might read clearer, though that's your call.

@lesnik512 lesnik512 mentioned this pull request Jul 25, 2026
34 tasks done
sbarkalov pushed a commit to sbarkalov/awesome-analysis that referenced this pull request Jul 26, 2026
Describe the subject in the top blockquote and move the web version link
into Footnotes, per review feedback on sindresorhus/awesome#4350.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ButZrE3VcdwmF7z2Mn64qx
@sbarkalov

Copy link
Copy Markdown
Author

Both fixed, thanks.

The blockquote now describes the subject instead of the list:

Business, systems, and product analysis turn stakeholder needs into clear, verifiable requirements, designs, and product decisions.

I also trimmed the paragraph under it so it isn't saying the same thing twice. The web version
link moved down to a Footnotes section;

On the name, I'll try to keep Analysis. Business analysis is the biggest slice, but modeling
notations, integration and API analysis, and product analytics are a decent chunk of the list
and none of that is business analysis, so the narrower title would oversell one part of it.
But I agree, and one day it should be split when we have gathered enough knowledge of the specific analysis type.

@VictorOsondu

Copy link
Copy Markdown

Great list. In my opinion, the AI & Agentic Analysis is the weakest section in this tight list. Claude, ChatGPT, Gemini, DeepSeek and Qwen sit there with near-identical descriptions — all variations on "assistant for drafting requirements". A reader who needs to be told ChatGPT exists isn't the reader for this list, and five general-purpose chatbots will date faster than anything else here. The entries doing real work are Spec Kit, OpenSpec, ChatPRD and MCP, because those are specific to the analysis workflow. I'd cut the general assistants down to a line of prose or drop them. Separately, Awesome LLM Apps is an awesome list, so it probably belongs under Related Lists. 'Prompt Engineering Guide' would probably fit best in 'Learning Resources'.

@VictorOsondu VictorOsondu mentioned this pull request Jul 28, 2026
35 tasks done

@mxuexxmy mxuexxmy left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Reviewed the entry and awesome-analysis.

Entry formatting is fine (title case, #readme, bottom of Business, description ends with a period).

Feedback on the list:

  • The name Analysis is very broad. Consider whether a more specific title (e.g. business/systems/product analysis) would better match the actual scope and avoid looking like a catch-all.
  • In AI & Agentic Analysis, several items are general-purpose AI tools (Claude, Cursor, GitHub Copilot) rather than analysis-specific resources. Guidelines ask for curated “best of” items for the theme — those may read as filler unless each description makes the analysis use case much more concrete, or they are dropped in favor of analysis-native tools.
  • The intro line with the sparkle emoji is optional noise for an Awesome list; not a hard rule violation, just polish.

Otherwise structure (badge, Contents, CC0, contributing) looks compliant.

@mxuexxmy mxuexxmy mentioned this pull request Jul 29, 2026
35 tasks done
@sbarkalov

sbarkalov commented Jul 29, 2026 •

Copy link
Copy Markdown
Author

Thanks both, @VictorOsondu and @mxuexxmy. You landed on the same section, so I reworked it.

I removed five general assistants, replaced by one line in the intro, and Cursor and Copilot went with them for the same reason. Awesome LLM Apps moved to Related Lists, Prompt Engineering Guide to Learning Resources. Added a few analysis-native things instead - the MCP registry, Atlassian's MCP server, Agent Skills.

Awesome LLM Apps moved to Related Lists and Prompt Engineering Guide to Learning Resources.
Both were misfiled, thanks for catching it.

On the name, I would suggest to keep Analysis, same reasoning I gave lesnik512 earlier: business analysis is
the biggest part, but systems and product analysis are a real chunk of the list and a narrower
title would misrepresent what's in it. All in all, i will be ready to rename it to Business Analysis as parent domain name, but lets postpone/sync this question with Sindre, please.

@jordanricky1604-ship-it jordanricky1604-ship-it left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Hey! Great list. The topic is really solid and the formatting looks completely in line with the guidelines. One very minor thing I noticed is that some descriptions might be a tiny bit long - Sindre's guidelines mention keeping descriptions succinct (ideally fitting on one line if possible). Other than that, everything looks perfect, including the awesome-lint passing status. Nice work!

@sbarkalov

Copy link
Copy Markdown
Author

Hey! Great list. The topic is really solid and the formatting looks completely in line with the guidelines. One very minor thing I noticed is that some descriptions might be a tiny bit long - Sindre's guidelines mention keeping descriptions succinct (ideally fitting on one line if possible). Other than that, everything looks perfect, including the awesome-lint passing status. Nice work!

@jordanricky1604-ship-it Thanks for the review! trimmed the long ones were over the line, so every entry renders on a single line

@reinaldosimoes

reinaldosimoes commented Aug 21, 2026 •

Copy link
Copy Markdown

The README still ends with a CC0 badge and waiver sentence. The current submission requirements explicitly say not to add the license name, text, or a License section to the README because GitHub already exposes the root license file. Since the repository already has a LICENSE file, I would remove that final badge and waiver block and let the root file carry the licensing information.

@reinaldosimoes reinaldosimoes mentioned this pull request Aug 21, 2026
27 tasks done
@sbarkalov

Copy link
Copy Markdown
Author

The README still ends with a CC0 badge and waiver sentence. The current submission requirements explicitly say not to add the license name, text, or a License section to the README because GitHub already exposes the root license file. Since the repository already has a LICENSE file, I would remove that final badge and waiver block and let the root file carry the licensing information.

thanks for raising it, updated the repo

@sbarkalov

Copy link
Copy Markdown
Author

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants