nirvana readme architect
Squad de geração de README.md perfeito e impecável, combinando análise profunda de codebase, seleção de template por tipo de projeto, todas as features do GitHub Flavored Markdown, validação com checklist de 25+ pontos e polimento final com badges e TOC.
📜 Nirvana README Architect (NRA)
स्क्वाड (Squad Protocol v5) जो किसी भी प्रोजेक्ट के लिए सटीक README.md बनाता है — गहन कोडबेस विश्लेषण, बुद्धिमान टेम्पलेट चयन, GitHub Flavored Markdown की सभी सुविधाएं, 25+ बिंदु चेकलिस्ट सत्यापन और अंतिम पॉलिशिंग का संयोजन।
विषय-सूची
- अवलोकन
- एजेंट
- पाइपलाइन
- शुरुआत
- कमांड
- आर्किटेक्चर
- समर्थित GitHub सुविधाएं
- गुणवत्ता चेकलिस्ट
- समस्या निवारण
- योगदान
- लाइसेंस
अवलोकन
Nirvana README Architect 5 विशेष एजेंटों का एक स्क्वाड है जो किसी भी कोडबेस को पेशेवर-स्तर की README में बदलने के लिए पाइपलाइन में काम करते हैं।
साधारण जनरेटर के विपरीत जो सामान्य टेम्पलेट बनाते हैं, NRA:
- वास्तविक कोडबेस का विश्लेषण करता है (टेक स्टैक, स्क्रिप्ट, एनवी वेरिएबल, डायरेक्टरी संरचना)
- प्रोजेक्ट प्रकार के अनुसार आदर्श टेम्पलेट चुनता है
- सभी GitHub Flavored Markdown सुविधाओं का उपयोग करके सामग्री बनाता है
- 25+ बिंदु चेकलिस्ट और स्वचालित स्कोरिंग के साथ सत्यापित करता है
- बैज, TOC, कोलैप्सिबल सेक्शन के साथ पॉलिश करता है
एजेंट
| एजेंट | व्यक्तित्व | आर्कीटाइप | भूमिका |
|---|---|---|---|
nra-orchestrator | Quill | FlowMaster | संपूर्ण पाइपलाइन का समन्वय |
nra-codebase-analyzer | Prism | Seeker | गहन कोडबेस विश्लेषण |
nra-content-architect | Serif | Architect | टेम्पलेट चयन और सामग्री निर्माण |
nra-quality-validator | Lens | Guardian | 25+ बिंदु चेकलिस्ट सत्यापन |
nra-polisher | Gloss | Alchemist | अंतिम पॉलिशिंग |
पाइपलाइन
Parse → Scan → Draft → Validate → Polish → Revalidate → Deliver
| चरण | एजेंट | विवरण |
|---|---|---|
| Parse | Quill | प्रोजेक्ट, प्रकार और दायरा पहचानना |
| Scan | Prism | गहन कोडबेस विश्लेषण |
| Draft | Serif | टेम्पलेट चुनना और सामग्री बनाना |
| Validate | Lens | 25+ बिंदु चेकलिस्ट, स्कोरिंग |
| Polish | Gloss | TOC, बैज, स्पेसिंग |
| Deliver | Quill | मेट्रिक्स के साथ डिलीवरी |
शुरुआत
git clone https://github.com/gutomec/nirvana-readme-architect.git
squads install gutomec/nirvana-readme-architect
@nra-orchestrator
*readme {प्रोजेक्ट-पथ}कमांड
| कमांड | विवरण | एजेंट |
|---|---|---|
*readme {प्रोजेक्ट} [प्रकार] | संपूर्ण पाइपलाइन | Quill |
*readme-full | सभी 12+ अनुभाग | Quill |
*readme-quick | 6 आवश्यक अनुभाग | Quill |
*scan | गहन विश्लेषण | Prism |
*validate | चेकलिस्ट सत्यापन | Lens |
*polish | विजुअल पॉलिशिंग | Gloss |
आर्किटेक्चर
nirvana-readme-architect/
├── agents/ # 5 विशेष एजेंट
├── tasks/ # 7 निष्पादन योग्य कार्य
├── workflows/ # जनरेशन पाइपलाइन
├── checklists/ # 25+ सत्यापन बिंदु
├── templates/ # GFM के साथ मास्टर टेम्पलेट
├── config/ # मानक और टेक स्टैक
└── squad.yaml # स्क्वाड मैनिफेस्टसमर्थित GitHub सुविधाएं
Alerts, Mermaid Diagrams, Tables, Collapsed Sections, Task Lists, Footnotes, Badges, Emojis, kbd Tags, Code Blocks, Diff Blocks, Reference Links — 12 पूर्ण सुविधाएं।
गुणवत्ता चेकलिस्ट
| स्कोर | स्तर | कार्रवाई |
|---|---|---|
| 90-100 | 🏆 निर्वाण | डिलीवर करें |
| 75-89 | ⭐ अच्छा | पॉलिशिंग भेजें |
| 60-74 | ⚠️ स्वीकार्य | पुनः काम करें |
| < 60 | ❌ अपर्याप्त | फीडबैक के साथ पुनः काम |
समस्या निवारण
| समस्या | समाधान |
|---|---|
| कम स्कोर | *readme-full के माध्यम से मैन्युअल डेटा प्रदान करें |
| गलत टेम्पलेट | प्रकार निर्दिष्ट करें: *readme {प्रोजेक्ट} api |
योगदान
योगदान का स्वागत है। कमिट संदेशों के लिए Conventional Commits का पालन करें।
लाइसेंस
MIT के तहत लाइसेंस प्राप्त — LICENSE देखें।
समीक्षाएँ
0 समीक्षाएँअभी तक कोई समीक्षा नहीं। इस स्क्वॉड की पहली समीक्षा लिखें!
Luiz Rodrigues से और
squad forge
Squad meta de desenvolvimento, otimização e evolução de squads agênticos — cria, valida, otimiza e moderniza qualquer artefato de squad (agentes, tasks, workflows, skills, squads inteiros, templates) com perfeição de formato, e mantém a própria base de conhecimento atualizada via pesquisa web.
ultimate landingpage
Squad fullstack para criação de landing pages de ultra-alta conversão — pipeline end-to-end com 9 agentes: discovery de produto, pesquisa de mercado e experts de copywriting, design system atômico com contraste WCAG AAA e light/dark, geração de imagens por IA, frontend Next.js com SEO e acessibilidade, backend Python FastAPI com admin panel e exportação CSV, integrações WhatsApp e email, e QA multidimensional com score por dimensão
data quality guardian
Squad especialista em qualidade de dados — profiling de datasets, detecção de anomalias, validação de schemas, geração de relatórios de qualidade e sugestão de remediações automatizadas para pipelines de dados
incident response squad
Squad especialista em resposta a incidentes para DevOps/SRE — análise de logs multi-source, correlação de causa raiz, execução de runbooks de remediação, comunicação de status e geração de post-mortems blameless
brandcraft
Squad de produção de entregáveis visuais brand-consistent: extrai design systems de URLs (Refero + live extraction), gera PDFs, PPTX, posts sociais, carrosséis e vídeos programáticos por dois caminhos (Veo 3.1 + Remotion para footage de IA; HyperFrames HTML-first determinístico para motion-design, data-viz e explainer), faz auditoria competitiva de marca, aplica um quality gate awwwards de 24 itens e um arsenal de 112 bibliotecas de UI nos HTMLs/PDFs/animações, e valida acessibilidade WCAG 2.2 AA. Pipeline com 16 agentes especializados e 16 workflows.
nirvana squad creator
Gera squads v5-compliant a partir de linguagem natural — pipeline de 11 fases começando com intent archaeology + pesquisa web (2026), depois análise grounded, geração, otimização, validação, README multi-idioma, deploy e publicação no squads.sh
notebooklm automation
Automação programática completa do Google NotebookLM — da criação de notebooks e curadoria de fontes à pesquisa por Q&A progressivo e geração de 10 formatos de conteúdo (podcast, vídeo, slides, quiz, flashcards, infográfico, mapa mental, tabela de dados, relatório), com download de artefatos orquestrado por pipeline inteligente. Suporta 50+ idiomas e error handling cross-cutting (retry, re-auth, fallback de cota).
soc alert triage
Squad especialista em triagem de alertas SOC para cybersecurity — classificação automatizada, filtragem de falsos positivos, priorização de ameaças, enriquecimento com threat intel e geração de briefs para analistas
adaptive tutor k12
Squad especialista em tutoria adaptativa K-12 — avaliação diagnóstica, mapeamento curricular personalizado, sessões de tutoria com dificuldade adaptativa, rastreamento de progresso e relatórios para pais e educadores
resume screener squad
Squad especialista em triagem de currículos para recrutamento — parsing automatizado de CVs, matching de skills com requisitos da vaga, auditoria de vieses, ranking de candidatos e geração de resumos executivos para hiring managers
automated code review squad
Squad especialista em code review automatizado — revisão de segurança, análise lógica, verificação de padrões arquiteturais, enforcement de coding standards e geração de review summaries priorizados para PRs e commits