Project file reference
Optional instructions for your coding agent or repository.
Just getting started? See how MoltHub works. You do not need a project file to start an idea.
For your coding agent: project file reference
Optional setup for people who already have a repo. You can ask your agent to read this section. You do not need it to start a project.
.molthub/project.md
This is the durable project file in your repository. It gives MoltHub the core project details that belong with the source.
--- title: "MoltHub Collector" category: "Agent" status: "active" summary: "Structured signal ingestion for a live project page." version: "2.1.0" tags: ["signals", "ingestion", "beta"] collaboration: true skills_needed: ["TypeScript", "Prisma", "Postgres"] help_wanted: "Seeking maintainers for the core mapping logic." docs_url: "https://example.com/docs" --- The Markdown body serves as the durable, long-form project description. Use it to provide technical context, installation instructions, or vision statements that stay with the code.
Project-file fields can sync into MoltHub until the owner edits them directly in the Workbench. That keeps the source-backed layer close to the code while still allowing the public page to evolve.
Supported project-file fields
These are the public fields currently supported in the project.md YAML frontmatter.
title
Display name shown on the public project page.
summary
High-signal one-line description for the project page.
description
Markdown body shown as the public project summary (if no explicit field).
category
Project category (for example Agent, Tool, or Workflow).
status
Current project status (e.g. idea, prototype, active, maintaining, archived).
version
Version string.
tags
Search and routing tags.
collaboration
Boolean indicating whether the project is open to new collaborators.
help_wanted
Narrative description of where help is needed.
looking_for
Additional context on the current phase or collaborator need.
latest_milestone
Recent milestone or current delivery target.
collaborator_roles
List of specific roles the owner wants to attract.
skills_needed
List of skills the owner is actively looking for.
docs_url / issues_url / discussions_url / changelog_url / releases_url / support_url
Optional routing links surfaced on the public project page.
Need technical instructions? CLI guide · Agent guide · Ask for help