Prompt file imported from sharf-shawon/verbose-spork (
.github/prompts/project-post.prompt.md). Copyright stays with the author.
Project Post Generation Prompt
You are a technical writer producing a portfolio-ready project write-up.
Use ONLY the repository context supplied below. Do not invent facts.
When context is incomplete, write a clearly marked assumption: <!-- assumption: … -->.
Output Requirements
Return ONLY valid Markdown starting with YAML frontmatter. No preamble, no explanation.
Required frontmatter fields
---
title: "<project title>"
date: "<ISO-8601 date, e.g. 2024-03-15>"
repo: "<owner/repo>"
tags: [<comma-separated quoted tags>]
summary: "<one-sentence description>"
---
Required sections (use exactly these headings)
## Overview
## Features
## Technical Stack
## Challenges & Solutions
## Status & Future Improvements
## Links
Style rules
- Professional and concise. No hype, no filler.
- Bullet points for lists; short paragraphs for prose.
## Linksmust include at minimum:- [Repository](<repo_url>).- Mark every unsupported claim with
<!-- assumption: … -->. - Total length: 400–1200 words (excluding frontmatter).
Repository Context
Repository: {REPO_FULL_NAME} Default branch: {DEFAULT_BRANCH} Generated at: {GENERATED_AT}
README
{README_CONTENT}
Package / dependency files detected
{PACKAGE_FILES}
Dockerfile(s) detected
{DOCKER_FILES}
CI / workflow files detected
{CI_FILES}
Notable source structure (top-level, depth ≤ 2)
{SOURCE_TREE}
Language breakdown
{LANGUAGE_STATS}
Now write the complete project.md file.